“The best documentation is written by people who are using it.” —Milana Cap
In this episode of Post Status Excerpt, Milana Cap tells David about the stark reality of the near-overwhelming workload facing the WordPress Documentation Team. Currently, about four sponsored volunteers and fewer than 10 volunteers in total make up the Docs team — a team that is assigned to manage documentation for software that powers over 43% of the web. If you have ever complained about outdated documentation or a lack of documentation for WordPress, listen to this episode.
Also: Milana shared some encouraging projects and efforts — much of which is recent and associated with the upcoming WordPress 5.9 release. Writers “shadowing” developers could be one of the keys to improving the quantity and quality of documentation in the future.
Every week Post Status Excerpt will brief you on important WordPress news — in about 15 minutes or less! Learn what’s new in WordPress in a flash. ⚡
You can listen to past episodes of The Excerpt, browse all our podcasts, and don’t forget to subscribe on Spotify, Amazon Music, Google Podcasts, iTunes, Castro, YouTube, Stitcher, Player.fm, Pocket Casts, Simplecast, or by RSS. 🎧
🔗 Mentioned in the show:
- Docs team handbook (if anyone wants to join)
- Developer Docs (DevHub)
- End user docs (also known as HelpHub in Make teams)
- Milana Cap (Twitter)
- David Bisset (Twitter)
- Post Status (Twitter)
🙏 Sponsor: Wordfence
Who can afford downtime, a black mark on their brand’s reputation, or the SEO impact of getting hacked? That’s why so many WordPress sites rely on the real-time protection provided by Wordfence Premium. Now, Wordfence Central offers Premium subscribers a powerful and efficient dashboard to manage security for all their sites from one central location. Try Wordfence today!
