Docs Chat: May 22, 2014

Thank you to everyone who came.

The following is a summary of the topics discussed.

1. Deprecated files issue: @siobhan asked us to discuss Item 1 under Current Priorities in the DevHub chat summary – does it make sense to use @deprecated tags in the file header of deprecated files? The consensus reached by the team was @deprecated tags should not be used in a file header to designate a file as deprecated, or that it contains deprecated items.

2. DevHub: The weekly chat summary included a list of the team’s current priorities, which includes several open Meta Trac tickets. There was also an explanation of the team’s current organization structure and goals. They currently need feedback on code reference explanations, as well as the proposed search results badges.

3. Handbooks: @samuelsidler posted a summary of the weekly Handbooks chat containing the current status of both Developer Handbooks. Good progress was made on both, and there are several new contributors. If you’re interested in helping, you can contact @blobaugh and @sewmyheadon at the email addresses listed in the post. A reminder that the next Docs Sprint is Saturday, June 7, 2014 at 10am PDT – they’ll be meeting in-person in Seattle, and virtually in #wordpress-sfd.

4. Admin Help: @Clorith said the team is defining components (work flows) for user testing. They’ll be looking into doing more in-person testing at local WordPress meetups and WordCamps, which will eliminate potential time constraints from user testing services. I suggested they also reach out to meetup organizers for help in identifying areas that new users are struggling with. (weekly chat summary)

For anyone unable to attend, you can read the chat logs here.