Learned about helping out and getting started with documentation this past weekend at WordCamp LA. Edited my first page in the theme handbook and looking forward to digging in some more 🙂 I’m a designer, not a developer, so I’m focusing on clarity and ease of understanding, consistency in formatting, etc.
I do have some questions about formatting for consistency, such as:
- Sometimes things are capitalized and sometimes the same thing isn’t … so, what should be capitalized and what should not? (i.e. post, page, Post Type, Custom Post type)
- In a list of items, if not in a bulleted list, do you want the comma used before the “and” or not?
- In a bulleted or numbered list, should each item have an initial cap or not?
- And regarding consistency in bolding, should code references (i.e. post_type) use a bold or regular style?
I’m sure I’ll have other questions as I go, but I’m looking forward to digging in, reading all your hard work, & learning! Oh, and please let me know if I do something wrong or mess anything up … just a little nervous about getting started 🙂