A Twitter discussion this morning spawned a conversation about the lack of breadcrumbs to support in the Codex, namely for theme authors looking to ask questions about the theme review guidelines.
The Docs team is compiling a list of articles that point out some of the support pathways, such as mailing lists, IRC, the forums or other channels.
We welcome any input and discussion: https://make.wordpress.org/docs/2013/01/10/missing-breadcrumbs-to-support/
We should probably get a conversation going not only about needed Codex work but *how* to approach a better structure and how to get the work done.
I’m leaning towards a re-org and maybe a bit of a division between users docs and programmer notes. A good example of this the Pages page. It starts out as a user doc then jumps right into code.
Things like Handbooks need to be sorted out and linked to as well.
I think if we could sort out the right approach first and focus on specific pages or topics later, then we’d start making big progress. Possible if we even approached it like a WP dev cycle, with clear targets and a deadline.
Possibly a mentorship program as well, wehre we could round up people to help and start handing out assignments and being there to keep people on task and for any questions they have.
All thoughts welcome here. 🙂