-
·
Team Reps
Siobhan McKeown and Drew Jaynes. Congrats! The term starts with the new year, so I’ll be in touch before then to make sure everyone is on the same page regarding expectations. Here are the voters: Please describe your role with the docs team. 4 – I am an active member of the doc team, and…
-
·
Plugin and Theme Developer Handbooks: Schedule
In January, it’ll be time to get started working properly on the handbooks. Start date will be January 7th (since I’m going to be on holiday until then 🙂 I’ve made a few different schedules since some handbooks will take ages. Others will take only a month or so of work. Note: we will be…
-
·
Best Practices for Handbooks
The following handbooks will need best practices drawn up: Theme Developer – UIUI UI is an acronym for User Interface – the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing./UXUX UX is an acronym for User Experience – the way the user…
-
·
Contributor Handbooks: Schedule
In January, it’ll be time to get started working properly on the handbooks. Start date will be January 7th (since I’m going to be on holiday until then 🙂 Note: we will be looking at other user-focused handbooks to create some time in the new year. If you don’t feel up to pluginPlugin A plugin…
-
·
Docs/Support Chat 20th December
The last chat before Christmas! Here’s what we discussed: Docs Sprints We talked about how to facilitate documentation sprints at WordCamps. These could be run on hack days. It’s important that we create targeted projects that groups of people could complete in about a 6 hour session. Obviously we don’t know who will be at…
-
·
WordPress Codex Sprint Round-up
The first WordPress codexWordPress Codex Living online manual to WordPress.org https://codex.wordpress.org/ sprint was a success! A bunch of us got together in the #wordpress-sfd chatroom and ploughed through the majority of the docs. You can see how successful we were by checking out our to-do list. There are a few things left on the list…
-
·
MediaWiki formatting
The styles for the WordPress CodexWordPress Codex Living online manual to WordPress.org https://codex.wordpress.org/ are different from other wikis. For specifics, see Codex:Styles. The following editing styles and markup cover the specific style of the Codex and includes recommendations and structure formats from MediaWiki’s Guide: Editing Overview. For more information on styling these pages, see: Guide…
-
·
Writing tips
The WordPress Codex is written in second person familiar in English. This removes the “I” from the instructions and tutorials and puts “you” in the driver’s seat. Here’s two paragraphs to compare the difference: I needed to display my categories in the sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes…
-
·
Creating a new document
You will learn how to create a new page in this guide. Before you start on this, you should have read the Guide to creating User Pages, and created a User Page for yourself. That allows you to create your own personal testing ground for new pages and rough draft articles. We cover creating an…
-
·
Documentation contributor handbook
This handbook contains information about how to contribute to WordPress documentation and be a member of the Documentation team. Who is in the Documentation team? Documentation team consists of volunteers and a few sponsored contributors with various backgrounds, levels of knowledge and experience working with WordPress. The team is maintaining both: end user and developer…