Open clausmullie opened 7 months ago
The introduction to the standard page includes a lot of "how do we do stewardship" information that perhaps lives best on the introduction to stewardship page.
When you say "introduction", do you mean the text before the "Standard compliance or certification process" section?
When you say "introduction", do you mean the text before the "Standard compliance or certification process" section?
No, I meant the entire page. But on second thought, I'm doubting my original issue.
I realize, though, that there isn't much of a text overview/introduction. The video has it all, but for someone just reading, it goes from the lead straight into the certification. One more paragraph under the video, summarizing it, would be a great addition.
Following our call this morning, we summarized the actions to these two (for this repository):
My notes from the call
There are three use cases for the standard 1) It's a reference document that anyone can use in whatever way they want --> The 'agnostic' product/tool 2) It's something we can audit a community/codebase against --> Codebase auditing 3) It's something we can use as guide to work with a community/codebase to get standard compliance --> Codebase stewardship
This should include a nice simple introduction to the standard to orient readers (+video) Followed by a brief section on each of the use cases, speaking to the user, what it can do for them, and how to get involved, with links to:
standard.publiccode.net Community-oriented product page, with info about the community call, translations, etc. Agnostic of how it's used
publiccode.net/auditing (?) Current content that's on publiccoden.net/standard, with deeper links into about
publiccode.net/stewardship I noticed this currently doesn't link to the standard, might be good to add that at the bottom
- I noticed this currently doesn't link to the standard, might be good to add that at the bottom
It links to standard.publiccode.net on line 37, but perhaps that link should go to the page about the standard on publiccode.net instead?
The repository for the Standard for Public Code is made as neutral as possible - it contains only the standard, with all the stewardship related things moved into About. I remember this was to make the Standard a stand alone asset anyone can use and reuse as they see fit, while stewardship is something particular to our organization.
However, I get the sense this separation is not made as clearly on the homepage. The introduction to the standard page includes a lot of "how do we do stewardship" information that perhaps lives best on the introduction to stewardship page.
If we want to promote it as an asset separate from our stewardship activity, it would be best to untangle these two elements, keep the standard page strictly about the standard (and include community-inviting things like the community calls, translations, different ways it's being used and by who, etc) with a mention+hyperlink that we use it for stewardship. And then move all the audit/certification content to the stewardship page.