...
As such, this site constitutes advice and best practice, while policy should be on the main apache.org site, or on the site of the specific VP (eg, Legal, Trademarks) who is responsible for that policy. Any time we find ourselves veering into "you must" rather than "you should", we should identify the top-level policy page that already addresses that topic.
QUESTION: what style guide should we use for signposting these kinds of links? We'll have a lot of different links back and forth with places like /dev; it would be helpful both as writers and for our audience to have a clear stylistic (or wording) way to signify "See the process over there" or "This is policy, if you'd like to know why it's here, see over there"
TODO
- TODO Purge ancient/outdated content
- Mentoring - we do not (currently) have a mentoring program
- Perhaps note that some projects/other areas might have mentoring programs?
- Delete content around a mentoring program
Move stuff that's actually about GSoC under GSoC
Remove mentions of 'helpwanted' service (Done)Remove references to speaker program (Unless someone wants to make that actually a thing)- Remove references to community.zones.apache.org
- Find out what that is (is it a VM?) and drop it. (Note: it still technically works with the map, but isn't useful, so agreed to decomission)
- About half of the files at the top-level of the site
comdevboardreports.mdnewsletter(Two editions, back in 2017. Seemed like a good idea at the time, but didn't last.)- calendars/ (This content is a duplicate of events.apache.org) (links to it removed; still need to clean content)
- Mentoring - we do not (currently) have a mentoring program
Top level content should help lead anyone - newcomers to the ASF, or committers at ASF projects looking for best practices - to the best place to find information about how the ASF operates.
Improve Onboarding
One of the best times to communicate processes is right when the person needs it; so making all onboarding docs and communications clear and consistent is important. While much of actual onboarding docs are on apache.org, many FAQs may be on community.a.o. See list of all onboarding touch points: Proposal: Improving Onboarding Experiences
Key navigation links to include - focus on newcomers
...