Documentation

Leonardo Losoviz explains how you can…

Photo of author
Dan Knauss

Leonardo Losoviz explains how you can show documentation to the user directly in the WordPress editor using Markdown. He claims that using Markdown instead of HTML is easier, and there are other benefits. Stressing that "localization for documentation is mandatory,"…

Justin Ahinon has a proposal for…

Photo of author
Dan Knauss

Justin Ahinon has a proposal for a new approach to Gutenberg developer documentation. Justin recently volunteered to be the Gutenberg developer documentation team representative. In his proposal, he asks for feedback in the comments. I have heard from several developers…

Over in SpinupWP’s impressive and broadly…

Photo of author
Dan Knauss

Over in SpinupWP's impressive and broadly useful documentation pages, there's a great new mini-tutorial on the best way to set up scheduled events in WordPress.  It also explains why the default WP-Cron configuration is truly "terrible." ⏰ TLDR: For something…

If you an experienced writer and…

Photo of author
Dan Knauss

If you an experienced writer and want to contribute to writing documentation and tutorials for WordPress, M Asif Rahman wants you to take a look at the WordPress projects in Google’s Season Of Docs 2020. There are some details to…

If you are looking for solid…

Photo of author
Dan Knauss

If you are looking for solid guidance on documentation writing, check this post featuring a video from speaker Daniele Procida. Daniele notes there are four kinds of docs: 1) learning-oriented tutorials, 2) goal-oriented how-to guides, 3) understanding-oriented discussions, and 4)…

The WordPress Documentation team is applying…

Photo of author
Dan Knauss

The WordPress Documentation team is applying to participate in Google’s Season of Docs, an initiative (now in its second year) that aims to improve open-source documentation. Jon (Kenshino) says there is a need for mentors "who are well acquainted or…

Cristina Holt from WebDevStudios shares some…

Photo of author
Dan Knauss

Cristina Holt from WebDevStudios shares some tips for leading a remote work team: 👩‍💻 Require a direct communication tool for all employees. Ensure your company has solid process documentation in place. Trust your employees and avoid micromanagement by setting clear…

Jon Quach, a designer at Automattic,…

Photo of author
Dan Knauss

Jon Quach, a designer at Automattic, has written a proposal for creating new WordPress Style Guide resources. Jon suggests, "It might be helpful to improve the guide by building resources in a new open documentation site, one with features like…

Andrey “Rarst” Savchenko details an exciting…

Photo of author
Dan Knauss

Andrey "Rarst" Savchenko details an exciting and long-awaited improvement to the Date/Time component in WordPress 5.3, which was made possible by raising the required PHP version for WordPress core to 5.6. ⌛ Andrey explains the Date/Time component previously relied on…

New Tools 🛠️ WPOnion is a…

Photo of author
Dan Knauss

New Tools 🛠️ WPOnion is a framework that "helps developers build custom meta boxes and custom fields in WordPress." The documentation goes into further detail, stating its support for not only post_meta but also term_meta, user_meta, comment_meta, settings pages and…

I appreciated this post from Josepha…

Photo of author
Dan Knauss

I appreciated this post from Josepha Haden on "Fostering Collaboration Across Cultures.” There are some excellent tips for both team members and team leaders here. Stereotypes can hinder communication, and I think even with the WordPress community being open and…

Jeff Matson gives us a peek…

Photo of author
Brian Krogsgard
Jeff Matson gives us a peek behind the curtains at NorthStack, which is a new managed application hosting service from the team at Pagely. Make sure to check out NorthStack's brand new documentation site.

Google is sponsoring a Season of…

Photo of author
Brian Krogsgard

Google is sponsoring a Season of Docs to bring technical writers and open source communities together for a time of learning and documentation writing. 📄 Applications open in early April. There could be some excellent opportunities here for the WordPress community.

Just another migration story

Photo of author
Brian Krogsgard
This past week it was necessary for me to spend time migrating a website and helping deploy a new design for it. It was a frustrating and humbling experience that also reminded me just how much of a challenge these…

There has been an official call…

Photo of author
Brian Krogsgard

There has been an official call for developer documentation about Gutenberg. One of the criticisms I've heard from developers is the lack of documentation, and it appears that's beginning to be addressed now. In this post, Chris Van Patten highlights the kinds…
A2 Hosting
WordPress.com