Blog for Public Code

This blogpost

3 June 2020 Standard for Public Code community call

Update from the Foundation




Renato joined the call for the first time and was curious about the Standard, and had heard about the new ‘open by default’ policy in the Netherlands. He shared a couple of links he found inspiring:

We gave a general introduction to the Foundation for Public Code, the Standard for Public Code, and the concept of codebase stewardship. We will stay in touch to see how we can collaborate further.

Anchors and deep linking

This topic was prompted by a discussion in GitHub.

Eric gave a practical example of how useful header links are for providing proper context and tracking when doing the codebase analysis, based on the length of the criteria.

We recognized that the situation could be improved by either making it possible to link to ‘chapter and verse’ (i.e. a specific requirement) or by making each criterion smaller, so context would be easier to keep.

We also acknowledged that our hesitation to make it harder to update the Standard stemmed from a feeling that we haven’t applied the Standard widely in practice yet. However, we also felt that the Standard is already useful when applied in practice, hence it cannot be too far from being mature.

This led us to a question: how will we know when the Standard is ready for 1.0.0? First we agreed on that we need to apply it more, and on different types of codebases to know. A useful signal would be how much change we felt that the Standard needed after each time we applied it. If that urge decreases, it is a good sign of maturity. So observing our own reactions can be a tool. Another way would be to talk with people in our community that are using the Standard. The best way to do this would probably be long form qualitative interviews to tease this out.

To push the Standard towards maturity, we discussed the idea of doing more quick iterations. This could possibly build on the idea of a shorter version questionnaire, like the one we had planned for a drop-in session at the March 2020 SCORE developer week in Ghent.

As a side track we discussed the template we used for the analysis, since it was when using it that we felt the need for deep links. Jan expressed that what was hard sometimes was to keep the context of each requirement in mind. Elena showed an example of expandable requirements from the UK. We agreed on that we need to iterate on this template, but had no concrete idea on the next step yet.

Finally we discussed looking into splitting up the criteria that have the most requirements. This could mitigate the need for deep links, and probably be useful anyway. The criteria that felt most urgent was Welcome contributions and Require review of contributions. We will continue to explore this since we have, unrelatedly, discussed splitting the first of these to focus on Community and Governance respectively in a better way.