Implementation guide for the Standard for Public Code

Bundle policy and source code This criterion in the Standard for Public Code

Requirements

The codebase MUST include the policy that the source code is based on.

Include links in the documentation to the policies that underpin the codebase or its deployments. If the policy is short, include it in full. If the policy is long, make sure that at least a summary is available in the documentation. Note that links to several layers of the policy might be useful, for example that the codebase aims to implement an EU directive, but a feature might specifically be made to comply with the law that is the implemenation of the directive in a single member state. In this case both levels are useful to include. When adding new features, document what policy they are meant to implement. Look if your context have collections of policies that apply to public organizations, like these for digitalization by the Swedish Agency for Digital Governement.

If a policy is based on source code, that source code MUST be included in the codebase, unless used for fraud detection.

(Do we have examples of this? OpenFisca?)

All policy and source code that the codebase is based on MUST be documented, reusable and portable.

(Do we have examples of policy that is reusable and portable?)

Policy SHOULD be provided in machine readable and unambiguous formats.

(Can most codebases do this?)

Tools

Continuous integration tests SHOULD validate that the source code and the policy are executed coherently.

(Any examples?)