Summary for Theme Developer Handbook Meeting 20 October

Attendance

@kenyasullivan @sheebaabraham @nao @hvillacorte @Kenshino

Introduction

@Kenshino took over the project from Flynn and Liz who had already completed 80-90% of the handbook with the previous team of contributors.

The current project direction is to just finish the To-do and In-progress items in the Trello Board and release the handbook as a version 1. Further will can continue on it after release.

To-do items are not placed in any form of priority and contributors should simply take the article that they feel they can better relate with.

Project Status

There are 9 articles in the ‘To-do’ list and 7 articles on the ‘In-Progress’ list (at time of meeting).

Team members have been asked to assign themselves a deadline on TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. and many committed to finishing it in a week.

General Info

For General formatting for handbook
https://make.wordpress.org/docs/handbook/developer-resources/handbooks/handbooks-style-and-formatting-guide/

To use the [code] shortcodeShortcode A shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site. created by the SyntaxHighlighter Evolved 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
https://en.support.wordpress.com/code/posting-source-code/

To-do list

@Kenshino pointed out that articles can be worked on together by different team members, each taking a different section. This is especially useful for articles that are mostly empty. Team members can add themselves onto the Trello card and comment on the task that they are undertaking.

Team members are also encouraged to add or remove tasks to articles.

State of Team & Direction

There are 10 members for the Theme Developer Handbook team, which I have a record at https://docs.google.com/spreadsheets/d/1hAPORz_yl4UTerPo8Tl5j_Xznfpm_NItrNftoXwBqvA/edit#gid=0

If every team member takes an article and work on it, we would be finished by the end of October.

@Kenshino is anxious to finish the handbook (at least version 1) for the following reasons

  • Themes submitted to the Theme Repository have been dropping in quality. Leading to a 6-7 month wait before Theme Reviewers can even get to a theme that one has submitted. It’s severely exhausting the Theme Review Team because they have to keep catching the same mistakes and do not have a real W.org resource to refer people to.
  • The Helphub Team (Creating a new system and re-writing articles for User Documentation – think ‘How to create a post’ type of articles) needs to know what articles that can off-load to us so that they can concentrate on what they need to do.
All of these projects are quite inter-linked and it looks like ours is easiest to finish so that we can be a form of support.

Open Floor

@kenyasullivan asked about a GithubGitHub GitHub is a website that offers online implementation of git repositories that can 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/ copy of the Theme Developer Handbook. Ideally, in the future, the handbook would have a feedback mechanism at the bottom of the article (similar to the Developer Documentation) and people can then contribute to the handbook.
Github is unlikely going to improve contributions after such a mechanism is put in place.
Team members with immediate questions should feel free to pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” @Kenshino on 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/., while non-urgent issues can be placed in Trello.

#summary