It occurs to me that I didn&#x27;t really answer the question as it was being asked, I blame it being after midnight when I wrote that (and being too excited about showing off my search thing).<p>We do have the technical part down pretty well, but actually managing the documentation is one area that we&#x27;re still lacking in. For the longest time our docs consisted mostly of just an API reference [1] and to be honest that did really cover about 90% of the needs of our customers, but that last 10% involved quite a bit of hands-on coaching with most of our customers to get them to understand the system as a whole before they could go off on their own and understand which API calls they&#x27;d need to make to do the thing they wanted to do.<p>One of the biggest helps has been keeping everything in github. Having all the docs be markdown is great because it&#x27;s just text so everyone can use the tools they want to, we&#x27;re not locked into some web wysiyg editor. And since it&#x27;s all in git it&#x27;s trivial for anyone in the company to open an issue about something incorrect or even submit a PR for anyone that&#x27;s more technical. Plus when someone does have a question that I and the other editors don&#x27;t know the answer to we can just git blame it to find out who put the piece in question there and ask them to clarify what they meant.<p>Now that we&#x27;ve been able to grow so much we&#x27;re getting more able to focus on polishing up the docs, which is actually officially my job now that I&#x27;ve moved from the support team into the (new) technical marketing team. We&#x27;ve started making more information that describes how the system works as a whole [2] so that we can have completely hands-off customers who just pay us money without us having to personally walk them through the system.<p>Of course there are other fun things that I intend to do with it like interactive demo API requests and auto generating a table of contents, but those are really just &#x27;wizz-bang&#x27; features that are fun and helpful but are definitely not required.<p>These are some of the other sites that I&#x27;ve taken (or am planning to take) inspiration from: [3] [4] [5]<p>[1] <a href="http:&#x2F;&#x2F;docs.exosite.com&#x2F;rpc&#x2F;" rel="nofollow">http:&#x2F;&#x2F;docs.exosite.com&#x2F;rpc&#x2F;</a><p>[2] <a href="http:&#x2F;&#x2F;docs.exosite.com&#x2F;oneplatform&#x2F;" rel="nofollow">http:&#x2F;&#x2F;docs.exosite.com&#x2F;oneplatform&#x2F;</a><p>[3] <a href="http:&#x2F;&#x2F;developer.wordnik.com&#x2F;docs" rel="nofollow">http:&#x2F;&#x2F;developer.wordnik.com&#x2F;docs</a><p>[4] <a href="https:&#x2F;&#x2F;www.twilio.com&#x2F;docs&#x2F;" rel="nofollow">https:&#x2F;&#x2F;www.twilio.com&#x2F;docs&#x2F;</a><p>[5] <a href="https:&#x2F;&#x2F;docs.particle.io&#x2F;" rel="nofollow">https:&#x2F;&#x2F;docs.particle.io&#x2F;</a>