When I first launched the landing page for the WordPress Plugin Boilerplate last year, the main idea was to grow a site around the single landing page that offered code examples, how to’s, and other forms of documentation.
But I’ve spent the last month working on some special material for the Boilerplate (that I’ll talk about in an upcoming post) which got me thinking more about what I wanted to offer in terms of documentation for the project.
And I’ve changed my mind.
When I first started out, the WordPress Plugin Boilerplate was supposed to be something that served two purposes:
- Provided a foundation for writing well-organized WordPress Plugins
- Be easily understood and accessible to as wide an audience as possible
I still want both of those things to happen, of course, but I think that in trying to setup a new site in order to make the Boilerplate as widely available as possible was a bit misguided. Simply put, the Boilerplate is for developers.
It doesn’t matter if you’re a beginner, it doesn’t matter if you’re intermediate, and it doesn’t matter if you’ve been writing plugins for years. In fact, odds are, if you’ve been doing this for years, you probably have strategies (some of which are probably better!) than what I have in place (and pull requests are always welcome :).
Regardless, the target audience is developers and since the code resides on GitHub, I think it only makes sense to keep all of the documentation, examples, and so on actually on GitHub. It’s where developers are going, it’s where developers will be.
To that end, rather than opening up documentation up on yet-another-site, I’m going to be using GitHub as the place to begin writing, collecting, and sharing the documentation.
And now that I’ve finished with the first pass (again, which I’ll share later), I can get into sharing more details about that in the future.
In the meantime, look for the documentation to begin taking shape on GitHub very soon.