Skip to content

Commit

Permalink
note how we approach multi-repository assessments
Browse files Browse the repository at this point in the history
(and fix some spelling)

Co-authored-by: Jan Ainali <jan@publiccode.net>
  • Loading branch information
ericherman and Ainali committed Jan 17, 2024
1 parent 45bbe2c commit 5efcd84
Showing 1 changed file with 12 additions and 3 deletions.
15 changes: 12 additions & 3 deletions activities/codebase-auditing/open-audits.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,21 @@ As much as possible, audits should take place in the open and be done together w

## Steps

1. Get explicit approval to start an open audit by asking the maintainer. Consider communicating that audit is starting, preferrably by encouraging the maintainer to do it, and possibly on [the blog](https://blog.publiccode.net) as well.
1. Get explicit approval to start an open audit by asking the maintainer. Consider communicating that audit is starting, preferably by encouraging the maintainer to do it, and possibly on [the blog](https://blog.publiccode.net) as well.
2. Create an issue in the repository for the codebase using the [review template](https://github.com/publiccodenet/standard/blob/develop/docs/review-template.html).
3. Start auditing the codebase in collaboration with the community. Preferrably, this involves more than one key contributor from the community and more than one codebase steward working together.
4. If the audit makes discoveries that can be addresses, create issues for those in the repository for the codebase, preferrably by encouraging the maintainer to do so.
3. Start auditing the codebase in collaboration with the community. Preferably, this involves more than one key contributor from the community and more than one codebase steward working together.
4. If the audit makes discoveries that can be addresses, create issues for those in the repository for the codebase, preferably by encouraging the maintainer to do so.
5. If many issues get created, ask to setup a Kanban in the repository for the audit with the columns Backlog, In progress, Done.

### Codebases which span two or more repositories

Sometimes, for instance in the case of Omgevingsbeleid, there are multiple repositories that makeup the software.
In these cases, we separately evaluate each repository, with the understanding that some requirements are not applicable to one or another.
Once each repository has been assessed, we can do an assessment of the whole stack, paying careful attention to whether or not there are any requirements which are not fulfilled by any repository.
So far, the developers of the different repositories have been known to each other and thus it has been easy to gain a shared understanding of which repository is responsible for various aspects when they are divided.
As an example, the documentation requirements of a feature may have different expectations in the front-end repository, back-end repository, and documentation repository.
Naturally, careful note-taking and reference-documenting in the assessment templates is even more important in these cases.

## Audits

Public assessments are linked from each codebase on [standard-compliant](https://standard-compliant.publiccode.net/#public-commitment) and if appropriate on our [page for codebases in stewardship](https://publiccode.net/codebases/).

0 comments on commit 5efcd84

Please sign in to comment.