I always had a good experience browsing documentation on <a href="https://readthedocs.org/">https://readthedocs.org/</a><div><br></div><div>Gerhard<span></span><br><br>On Thursday, 23 April 2015, Simon Morley <<a href="mailto:simon@polkaspots.com">simon@polkaspots.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hello All<div><div><div><div dir="ltr"><div><br></div><div><b>What do you use for your product documentation?</b></div><div><br></div><div>We just launched a new service and our docs were foolishly / typically left to the last minute.</div><div><br></div><div>Long-term we're going to use Github pages but we have no time (or people) to make it pretty. And add search. Or train those writing the docs.</div><div><br></div><div>In desperation, we've chucked them on <a href="http://readme.io" target="_blank">readme.io</a>. However, words cannot describe how terrible readme is. Avoid. Plague. Although it is superficially pretty:</div><div><br></div><div><a href="http://docs.cucumbertony.com" target="_blank">http://docs.cucumbertony.com</a></div><div><br></div><div>We already use Intercom for support so we need none of that. We have our api documentation on <span style="color:rgb(68,68,68);line-height:19.5px">apiary (http://</span><font color="#444444"><span style="line-height:19.5px"><a href="http://docs.polkaspots.apiary.io/#" target="_blank">docs.polkaspots.apiary.io/#</a>) </span></font><span style="color:rgb(68,68,68);line-height:19.5px">which is awesome.</span></div><div><span style="color:rgb(68,68,68);line-height:19.5px"><br></span></div><div><span style="color:rgb(68,68,68);line-height:19.5px">We j</span>ust a place for the end-user, customer facing, help-me style docs.</div><div><br></div><div><b>Stuff we tried:</b></div><div><br></div><div>- Zendesk - good support system, crap docs, terrible community aspect.</div><div>- Freshdesk - support orientated.</div><div>- Help Scout - ok but more about support. Ugly.</div><div>- Help Juice - OMG VPL expensive.</div><div>- Readme.io - genuinely made me irate.</div><div>- Desk - seemingly all about support.</div><div>- Atlassian - the peeps writing them couldn't understand it.</div><div>- Github pages - fabulous but needs attention and same issue as Atlassian.</div><div>- Userdeck - no idea what it does still.<br></div><div><span style="color:rgb(68,68,68);font-size:13px;line-height:19.5px">- HappyFox - v basic </span><font color="#444444"><span style="line-height:19.5px">apparently, didn't try.</span></font><br></div><div>- <span style="color:rgb(68,68,68);font-size:13px;line-height:19.5px">kayako - too complicated to set up.</span></div><div><br></div><div>We need something simple. With basic search. And it needs to be pretty. And easy to use.<br></div><div><br></div><div>If this magical beast doesn't exist, it should. I'd even write something with some of you.</div><div><br></div><div>Great product, shoddy docs. Not cool.</div><div><br></div><div>Help?</div><div><br></div><div>S</div><div><br></div><div><br></div>Simon Morley<br><span style="font-family:arial;font-size:small">Big Chief</span> | PolkaSpots Supafly Wi-Fi<div><br><div><div><span style="font-family:arial;font-size:small">simon@PolkaSpots.com</span><br style="font-family:arial;font-size:small"><div style="font-family:arial;font-size:small">Linkedin: I'm not on it, it sucks</div><div style="font-family:arial;font-size:small">020 7183 1471</div><div><br></div><div><br></div></div></div></div></div></div></div>
</div></div>
</blockquote></div><br><br>-- <br><div dir="ltr"><br><hr style="font-family:arial,helvetica,sans-serif"><font color="#3333ff"><font face="arial, helvetica, sans-serif"><a href="http://twitter.com/#!/gerhardlazu" target="_blank">Twitter</a> <a href="https://github.com/gerhard" target="_blank">Github</a> </font><a href="http://gerhard.lazu.co.uk/" style="font-family:arial,helvetica,sans-serif" target="_blank">Blog</a></font></div><br>