Handbooks Step 1: Creating the Table of Contents
We’re at the first stage of the handbooks, creating the table of contents. Here’s what you do:
Theme and Plugin Developer Handbooks
I have created two spreadsheets for these handbooks. Please go into the spreadsheets and start adding sections to the ToC. I’ve added links to ToC that were suggest to me for inspiration.
By creating the ToC like this we’ll be able to get an overview of the whole thing before we start creating pages. You can find them at:
The ToC should be finished by 21st January. We’ll review where we are at next week’s chat.
@rachelbaker will be the editor for the Theme Developer Handbook so she’ll be taking the lead on that one.
Am still looking for an editor for the Plugin Dev Handbook let me know.
When the ToC is finished I’ll create the pages and we’ll move on to the next step.
Contributor Handbooks
Most of these will be created at make.wordpress.org/area/handbook
You can see examples at:
Polyglots will be created on make/docs. We’re using Edit Flow to manage the editorial workflow here. If anyone else wants to build theirs on make/docs just let me know.
Core is a little bit different. It’s already got a lot of content there. I’m going to do an audit of the current content and then work with @japh and @danielbachhuber to see what we need to add and what needs to be fleshed out.
If you have any questions or if there’s anything that I’ve missed let me know.
Japh 12:49 pm on January 9, 2013 Permalink |
If you need a hand auditing the current content of Core, I’d be happy to help
Siobhan 1:01 pm on January 9, 2013 Permalink |
Great! I’ve started here: https://docs.google.com/spreadsheet/ccc?key=0AiTZlIvtDmPEdHYyUklNYjZoQVlxNVRvSnRWckhjZGc
You’ll see two tabs – current content and new structure
Let’s aim to have this complete and the new structure drawn up for 21st January.
esmi 1:04 pm on January 9, 2013 Permalink |
I’m happy to draft up something for the Accessibility sections of any of the handbooks. Can you ping me with rachelbaker’s contact details and I’ll liaise with her directly for the Theme Handbook?
Siobhan 1:12 pm on January 9, 2013 Permalink |
sent. thanks!
Pippin (mordauk) 10:48 pm on January 9, 2013 Permalink |
Looking great so far.
Daniel Bachhuber 2:36 am on January 11, 2013 Permalink |
I know I’m already signed up for the Core handbook, but plugin development is near and dear to my heart and I’d love to help out there too.
Siobhan 8:06 pm on January 11, 2013 Permalink |
Feel free to put your energies where your heart is. I’ll work on the core handbook with @japh and if we need your input I’ll give you a shout.
Jason Hoffmann 6:37 pm on January 11, 2013 Permalink |
Can I admit that I’m still a bit confused. Should we be going and just adding the TOC or is there some sort of process here. I’ve been looking it over just wondering how to go about that.
Siobhan 8:07 pm on January 11, 2013 Permalink |
Yes, please just go into the spreadsheet and add items to the ToC. Sorry if that wasn’t clear to begin with. I’ve added a sentence to the post to clarify.
tommcfarlin 4:01 pm on January 14, 2013 Permalink |
A bit late to the party – apologies for that – but am all caught up on what’s going on and am eager to get started.
I’ve been speaking with Siobhan about taking the “Editor” role for the Plugin Handbook – happy to do so. Once I review the list of all who are involved, I’ll shoot out an email and we can get to work on the ToC.
I know most of you who initially signed up, the rest of you I’m eager to work with. “I don’t know half of you half as well as I should like; and I like less than half of you half as well as you deserve.”
You know. All that jazz
.