Handbooks Chat: 19th Feb 2014

Welcome to the official home of the WordPress Documentation Team.

This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.

Want to get involved?

Start here to find out more about what we do and how to contribute:

Onboarding to Documentation Team: An overview of what we do and how to collaborate
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/

Weekly meetings

Join our discussions of documentation issues here on the blog and on Slack.

The documentation team holds weekly office hours and monthly Contributor Days on each Tuesday of the month in the #docs SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel. It’s also where you can contact the team at any time outside meetings.

@sewmyheadon, @blobaugh, and, @hanni had our first checkin yesterday.

Stated utility and purpose of the meetings: to support each other as far as possible, and ensure we’re all the right track with regards to the goals of the handbooks, focusing on incremental progress rather than becoming bogged down with concern over current timeline.
@hanni’s purpose to allow each editor to focus on their handbook whilst watching for potential problems or unwanted divergences, reviewing diffs on an at least weekly basis and helping out with editing when and as she can.
Agreed on the provisional contents the reference portion of PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party Developer Handbook cut up by @blobaugh and @hanni).
Started on new spreadsheet for the Plugin Developer Handbook to reflect structure update and porting of existing content (links forthcoming).
@sewmyheadon will be meeting with @philiparthurmoore to integrate the ThemeShaper tutorials and restructure Theme Developer Handbook as needed over the next ten days or so.
Welcomed new contributor @lorax who’ll be attending the docs chat today to get involved!

#handbook-chat

Siobhan Bamber (siobhyb) 12:55 am on February 21, 2014

I’d like to help out where I can with this, if you still need people? I won’t be able to attend the Weekly IRC Docs or Handbook chats because of time zones, but will make sure to read up on them.
Eric Amundson 1:19 am on February 21, 2014

@siobhyb – that’s awesome! We always need help and would really appreciate your contributions.

We’re working on revamping the intro for the Theme Dev Handbook, but you can visit the Theme Dev Handbook Spreadsheet from the link in the sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. of https://make.wordpress.org/docs/ and find something that interests you and work on it.

If you haven’t already, you might want to check out these docs:

• WordPress Style Guide
• Handbook Tutorial Template – a starter template with typical sections in a tutorial doc.

And, if you don’t have a lot of experience designing themes, you can simply start at the beginning, read, make comments and improvements, etc.

Cheers!
- Siobhan Bamber (siobhyb) 8:00 pm on March 10, 2014
  
  Thanks so much for the information @sewmyheadon. 🙂
lorax 1:41 am on February 21, 2014

Sorry I had to bail early. Thanks for the welcome @sewmyheadon. I assume I should do the same and visit the spreadsheet.
Eric Amundson 1:45 am on February 21, 2014

Yep, that’s a great idea @lorax. If you can start by reviewing the above links and then check out the spreadsheet and see what looks appealing, that would be great.

Cheers and thanks for the help!
lorax 1:48 am on February 21, 2014

Thanks Eric. Cheers to you as well.

Want to get involved?

Weekly meetings

Share this: