2014 WordCamp Phoenix - 30 Days in the WordPress Codex

Good documentation is necessary so that developers can find the answers they need without scouring the internet for relevant and timely information. But as WordPress continually evolves, so must the documentation that accompanies it. Keeping these resources accurate and up-to-date requires many contributors from around the WordPress community. During this session attendees will learn what I discovered during my first 30 days as a new contributor, what projects the Docs Team working on, how they can help and the many other ways they can contribute to WordPress.

Transcript

1. 30 Days in the WordPress Codex Presented by Nicole Arnold @nlarnold1 #30daysinWPCodex www.alleyinteractive.com @alleydev
2. ✔ Why the Codex? ✔ Why 30 Days? ✔ Why is this important? What's This All About?
3. ✔ About the Docs Team ✔ Benefits of contributing ✔ What else is there? ✔ Where to begin What You'll Be Learning
4. Current Documentation ✔ The Codex ✔ The Forums Documentation Challenges
5. Rapid changes ✔ New look (MP6) means new screenshots ✔ Deprecated functions ✔ New features, functions, hooks, etc. Documentation Challenges
6. Improving and keeping documentation up to date is an enormous task! Documentation Challenges
7. Inline Docs Current Projects
8. Inline Docs ✔ Over 1500 hooks ✔ 182 files ✔ About 20 files still up for grabs http://make.wordpress.org/core/2013/09/05/add-inline-docs-for-hooks/ Current Projects
9. Handbooks ✔ Theme Developer Handbook ✔ Plugin Developer Handbook ✔ Contributor Handbooks http://make.wordpress.org/docs/tag/handbooks/ Current Projects
10. Code Reference ✔ Parses the inline documentation into a user viewable resource ✔ Plan is to replace the Codex http://make.wordpress.org/docs/tag/code-reference/ Current Projects
11. devhub ✔ New portal for WordPress developers ✔ developer.wordpress.org ✔ Will contain the Code Reference and developer handbooks (Theme & Plugin) http://make.wordpress.org/meta/2013/08/14/developer-wordpress-org-specification/ Current Projects
12. AH-O2 ✔ “Breathing new life into admin help!” ✔ Present more useful help content (more 'how to' and less 'this is') ✔ Adds tooltips to admin pages https://make.wordpress.org/docs/tag/ah-o2/ Current Projects
13. Codex ✔ Current 'go to' place for developers ✔ Wiki, open to editing ✔ Large, incomplete, and difcult to maintain http://make.wordpress.org/docs/tag/codex/ Current Projects
14. Discover little known features function redirect_to_post_on_publish( $location ) { if ( $_POST['post_status'] == 'publish' && 1 === preg_match( "/post=([0-9]*)/", $location, $match ) ) { $location = get_permalink( $match[1] ); } return $location; } add_filter( 'redirect_post_location', 'redirect_to_post_on_publish' ); Benefits of Contributing
15. Discover little known features function add_click_tracking( $atts, $item, $args ) { $atts['onclick'] = sprintf( "_gaq.push(['_trackEvent', '%s', '%s', '%s' ]);", esc_js( $item->post_type ), esc_js( $args->theme_location ), esc_js( $item->title ) ); return $atts; } add_filter( 'nav_menu_link_attributes', 'add_click_tracking', 10, 3 ); Benefits of Contributing
16. Gain deep understanding Think of it as “continuing education” Stay on the cutting edge of WordPress Learn what's new and happening faster because you're 'in the know' Have fun Meet people, help others, give back Benefits of Contributing
17. Core Team: make.wordpress.org/core/ What they do: ✔ Develop new core features ✔ Maintain codebase How you can help: ✔ Fix bugs ✔ Beta testing Irc.freenode.net: #wordpress-dev What Else is there?
18. UI Team: make.wordpress.org/ui/ What they do: ✔ Handles user interface design and development How you can help: ✔ User Testing ✔ Quality Assurance irc.freenode.net: #wordpress-ui What Else is there?
19. Mobile Team: make.wordpress.org/mobile/ What they do: ✔ Develop ofcial WP apps How you can help: ✔ Great team for Java, Objective-C, and C# devs to join irc.freenode.net: #wordpress-mobile What Else is there?
20. Accessibility Team:make.wordpress.org/accessibility/ What they do: ✔ Supports Core with accessibility issues How you can help: ✔ Regular users of assistive technology wanted to test and give feedback irc.freenode.net: #wordpress-ui What Else is there?
21. Polyglot Team: make.wordpress.org/polyglots/ What is a polyglot? (n) “one who is polyglot” (adj) “knowing or using several Languages” http://www.merriam-webster.com/dictionary/polyglot What Else is there?
22. Polyglot Team: make.wordpress.org/polyglots/ What they do: ✔ Translate WordPress How you can help: ✔ If you are fuent in language other an English (US), you can help! What Else is there?
23. Support Team: make.wordpress.org/support/ What they do: ✔ Provide support to WordPress developers and users How you can help: ✔ Answer Support Forum posts ✔ Provide help in the chat room irc.freenode.net: #wordpress-sfd What Else is there?
24. Support Team: make.wordpress.org/support/ What Else is there?
25. Theme Review Team: make.wordpress.org/themes/ What they do: ✔ Review and approve themes ✔ Maintain theme test data & plugin How you can help: ✔ Test submitted themes ✔ Provide review results What Else is there?
26. Plugins Team: make.wordpress.org/plugins/ What they do: ✔ Manage the plugin directory ✔ Review submitted plugins ✔ Monitor security-exploit databases How you can help: ✔ Checkout a plugin and review ✔ Email with your results What Else is there?
27. Community Team: make.wordpress.org/community/ What they do: ✔ Support events like WordCamps ✔ Create outreach & training programs How you can help: ✔ Help organize a meetup ✔ Participate in promoting WordPress irc.freenode.net: #wordpress-getinvolved What Else is there?
28. make.wordpress.org/core make.wordpress.org/ui make.wordpress.org/mobile make.wordpress.org/accessibility make.wordpress.org/polyglots make.wordpress.org/mobile make.wordpress.org/support make.wordpress.org/docs make.wordpress.org/themes make.wordpress.org/plugins make.wordpress.org/community How to Contribute
29. irc.freenode.net Core: Weekly IRC chats: Wednesdays @ 21:00 UTC #wordpress-dev UI: Weekly IRC chats: Tuesdays @ 19:00 UTC #wordpress-ui Mobile: Weekly IRC chats: Mondays @ 16:00 UTC #wordpress-mobile Accessibility: Weekly IRC chats: Wednesdays @ 20:00 UTC #wordpress-ui Support: Weekly IRC chats: Thursdays @ 17:00 UTC #wordpress-sfd Documentation: Weekly IRC chats: Thursdays @ 17:00 UTC #wordpress-sfd Community: Weekly IRC chats: Thursdays @ 19:00 UTC #wordpress-getinvolved How to Contribute
30. ✔ You can do this. ✔ It's a win-win! ✔ No time like the present. Get Started
31. Thank You! Nicole Arnold @nlarnold1 #30daysinWPCodex www.alleyinteractive.com @alleydev