Docs Team Update: May 22, 2014

The following is a summary of the topics discussed during our weekly Docs chat:

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 headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. 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 MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. 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 meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. organizers for help in identifying areas that new users are struggling with. (weekly chat summary)

You can read the chat logs here.

#docs