The Ed-Fi Alliance relies on technical contractors for a variety of critical projects and functions. This documentation provides guidelines that every technical resource is expected to know.
Every technical contractor is expected to have read The Tao of the Ed-Fi Alliance, which provides an overview of the organization, its mission, and the principles that drive its work. The Code of Conduct applies to everyone working with the Ed-Fi Alliance – but technical contractors have a particular responsibility to exemplify the conduct the Alliance expects from its community.
Although the particulars are different based on a person's role, technical contractors are generally provided with access to the Ed-Fi Tracker / JIRA system, the Tech Docs / Confluence site, and GitHub repositories.
The Ed-Fi Developer Guide has a good overview of the resources available. Technical contractors can work with their internal project manager or Ed-Fi technical lead to be granted appropriate access.
The Ed-Fi Alliance expects every technical contractor to consider data security and student privacy at every stage of their work.
Some specific practices of note:
The above isn't meant to be an exhaustive list, of course. Check with your technology lead or Ed-Fi contact if you see any real or potential risks to security or privacy.
Tracker tickets must communicate clearly. This is true of all Alliance projects, but especially important on public-facing projects where a Tracker entry may be the only source of information about a planned feature or a critical bug.
Every project has its own particulars, but a few rules apply to all projects:
There is a difference between external, community-facing projects and internal projects:
In external-facing projects, some additional considerations apply:
Most Ed-Fi Alliance technical contractors also do work for the Ed-Fi Community.
1 Some teams use Tracker for long-term estimation and planning, and in those cases it's okay to have general ticket names. However, the ticket is expected to evolve into something specific and detailed as actual work gets underway.