Handbooks: Teams and Templates
Over the past few weeks I’ve been getting in touch with people who I’d like to see involved with the handbooks. I’m going to continue to do this over the next few weeks as we get started on working. I just wanted to give you an update on teams and templates.
Here’s who we’ve got so far:
[update: am adding more people to teams as they contact me]
(no one so far 🙁 )
(no one so far 🙁 ) Except Isaac?
These things span all of the handbooks:
Kari Leigh Marucchi
@helenyhou or other person from UI
We definitely need more people so if you know of anyone please send them this post. Or drop me an email: siobhan at wordsforwp dot com and I’ll get in touch with them personally.
After having chats with different people in different contributor groups and reviewing the material that we have already, I’ve come up with a very loose schema that I think will work across the handbooks.
All of the things you need to start contributing to this area
Useful tools to get started
The different ways that you can get involved in this area
Tutorials & Guides
Practical guides to doing what you need to do
Glossaries etc (maybe useful email addresses etc?)
Coding Standards, Best Practices, UI Guidelines, UX Guidelines, Accessibility
Lists the contributors to that manual.
This is a starting point, so please do make suggestions based on your own experience. There’s always a danger when you’re creating something generic that you lose the specific, which is why I’ve tried to keep the schema as loose as possible.
Some other things
I have a chat with Brad and Pippin about the plugin development handbook. They had some great ideas to keep in mind:
- We should use practical examples of code that will help people to learn
- We need a syntax highlighter of some description. We did discuss using Gists but then our docs are reliant on Github and that not something we want
I think there may have been other things so Brad and Pippin if I’ve forgotten something please chime in. Soon we’ll get into discussions about the particularities of specific handbooks I’m sure, but I wanted to note these here for the record
Next steps are as follows:
- Come up with schedule and workflow – I’ve got some stuff written down on this but will save for another post! Let’s aim for long term – we don’t want to burn ourselves out.
- Schedule some google hangouts with contributor groups and volunteers to discuss best practices
- Develop table of contents
Okay, phew! That was a long post again. Let me know if I’ve missed anything, please do add any suggestions or tell me where things can be improved.
Most importantly, spread the word. This is an exciting project in its beginning stages and over the next year we’ll be able to create something we’re genuinely proud of and that gets more people contributing to WordPress.