Remove/annotate links to private content in public handbook
There are a number of links to private threads on forum.opencraft.com or to private Jira tasks in our public handbook, e.g.
- https://handbook.opencraft.com/en/latest/how_to_do_estimates/#estimation-errors
- https://handbook.opencraft.com/en/latest/processes/vacation/#sick-days
- https://handbook.opencraft.com/en/latest/processes/developer_advocacy/#analysis
Because our handbook is public, these private links cause confusion and make our culture and processes opaque. They also clash with our Open First policy.
Note: anyone can create an account on our forum.opencraft.com site, but only people with verified opencraft.com emails get access to Private discussion threads.
Completion criteria
- Search through the handbook to locate links to tasks.opencraft.com, forum.opencraft.com, gitlab.com, or github.com which lead to private pages.
- For each one, consider whether the information held on that page can be sanitised and shared publicly, e.g. by:
- Making the entire discussion thread public -- requires agreement by the team, so please ask on the post before changing this.
- Capturing the public-appropriate information on that page and reproducing it in the handbook.
- If the information page should not be made public, consider whether the content of this link is critical to the reader's understanding of the handbook page it's on.
- If not, then it's ok to simply annotate the link to indicate that it's private to opencraft.com employees.
- But if so, rewrite the public handbook page from the public reader's perspective, and move any truly private information into opencraft's private documentation (with an annotated private link).
Edited by Jillian Vogel