Performance and Multisite help — book a call with me via my Expert page on Clarity, I use this service for calls.

Making documentation for WordPress plugin [Episode 5]

<p><em>Recap of Episode 5 of <a href=””>WordPress Plugin Startup Show</a>: 14 July 2020</em></p> <figure class=”wp-block-embed-youtube wp-block-embed is-type-video is-provider-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio”><div class=”wp-block-embed__wrapper”> <iframe title=”WordPress Plugin Startup – from 0 to 10k installs – Part 5″ width=”500″ height=”281″ src=”” frameborder=”0″ allow=”accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share” referrerpolicy=”strict-origin-when-cross-origin” allowfullscreen></iframe> </div></figure> <p>* <a rel=”noreferrer noopener” href=”” target=”_blank”>SpeedGuard</a> is a WordPress plugin to keep an eye on your site speed, in background.</p> <p>* <a rel=”noreferrer noopener” href=”” target=”_blank”>AB Split Test</a> is a WordPress plugin to&nbsp;improve&nbsp;your website conversions automatically.</p> <p></p> <p>In <a href=””>episode 4</a> we started talking about making documentation for WordPress plugin, and we continue today.</p> <h2 class=”wp-block-heading”>Good documentation helps users to find answers</h2> <p>Even super-tech documentation can be written for humans!<br>For example, API documentation can include a problem-solution approach rather than just a list of functions and methods. Even <a href=””>Google does that</a>!</p> <p>And you don&#8217;t really expect that much from giant, but you do expect a more personalized approach from a small company!</p> <p>I also find the GitHub Pages interface appealing for API documentation, here is what <a href=””>Timber&#8217;s docs</a> look like there.</p> <h4 class=”wp-block-heading”><strong>When users can easily find answers, it means:</strong></h4> <ol><li>less number of support tickets &#8211; obviously</li><li>more likely that people are getting the most out of the plugin&nbsp;</li><li>and therefore more likely that they will renew it!</li></ol> <h4 class=”wp-block-heading”>But also there are additional benefits:</h4> <ul><li><strong>The community around your product</strong> is building up. <a href=””>For instance</a>, ACF has a lot of questions answered on the forum. People help each other with specific problems. These pages are often the first search result when you googling something similar, and if you search ACF site they will br shown along with docs pages.</li><li>You get a chance<strong> to understand your users better</strong>: What are the most commented-upon items, for example? The most viewed? The most cited? It can reveal holes in the sales funnel too.</li><li>It helps to onboard new clients better (meaning, it <strong>helps to avoid refunds</strong>). <br>If they don&#8217;t know how to use your product, or can&#8217;t see all the benefits they might abandon it (not renewing a license is almost as sad as asking for a refund). But this doesn&#8217;t mean it doesn&#8217;t solve their problem! It&#8217;s just that you haven&#8217;t show properly that it does. Lose-lose situation.</li></ul> <h4 class=”wp-block-heading”>What sections should documentation include? What structure should it have?</h4> <p><a href=””>Toolset</a> used customer segments and customer journey to update their documentation recently. They explain things according to who is reading, and what that person is going to do with a help of their plugin. They even made a course for each case!</p> <figure class=”wp-block-image size-large”><img src=”×455.png” alt=”” class=”wp-image-20533″/></figure> <p><a href=””>WP Rocket</a> has a Troubleshooting section with lot&#8217;s of answers to cases then something doesn&#8217;t work as expected. It&#8217;s super relevant for any caching plugin users as each install has it&#8217;s own environment (plugins, themes, 3rdparties, server setup, CDN etc). And this is very common stage when people need assistance.</p> <figure class=”wp-block-image size-large”><img src=”×466.png” alt=”” class=”wp-image-20535″/></figure> <p><a href=””>Advanced Custom Fields&#8217;s documentation</a> expectedly has loads of technical information, and it&#8217;s organized in very clear way. </p> <p>For example, each field&#8217;s page has the following sections: Description, Screenshot, Settings and Template usage. So you can see the usage of that specific field from all sides. Also, I&#8217;m not the only one to notice that while ACF&#8217;s documentation is all about code and functions it doesn&#8217;t feel machine-to machine talk somehow, but human-to-human!&nbsp;</p> <figure class=”wp-block-image size-large”><img src=”×579.png” alt=”” class=”wp-image-20540″/></figure> <p></p> <p>Though these three plugins&#8217; documentation might look quite different I think all of them share the same approach. They target exactly on<strong> what their users will be looking for</strong>.</p> <p><strong>Next week we&#8217;ll be talking about</strong> using WordPress plugin documentation to get NEW users!</p> <div class=”wp-block-group”><div class=”wp-block-group__inner-container is-layout-flow wp-block-group-is-layout-flow”> <div style=”height:100px” aria-hidden=”true” class=”wp-block-spacer”></div> <h3 class=”wp-block-heading”><strong>Join us on this journey!</strong> </h3> <p>We are going go live in <a rel=”noreferrer noopener” href=”” target=”_blank”>WP Builds</a> Facebook group starting every Tuesday at 2 PM UK time. It&#8217;s a private group, so you need to join it first. After this, you&#8217;ll be able to watch us live <strong>and participate in a live conversation</strong>. If you happen to not have a Facebook account you can watch live <a rel=”noreferrer noopener” href=”” target=”_blank”>here</a> but you won&#8217;t be notified when we&#8217;re going live and won&#8217;t be able to participate in the conversation, unfortunately.</p> </div></div>

Leave a Reply

Your email address will not be published. Required fields are marked *