<div dir="ltr">Middleman plus Github Static pages is a nice option. Your documentation authors only need to be able to write Markdown.</div><div class="gmail_extra"><br><div class="gmail_quote">On 23 April 2015 at 13:51, Alex Reis <span dir="ltr"><<a href="mailto:alex@alexmreis.com" target="_blank">alex@alexmreis.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hey Simon,<div><br></div><div>Not quite the canned solution you were looking for, but last time I had to write help for a product I just stole Bootstrap's doc style and plugged it in with a set of static pages. Anyone who can edit HTML can maintain them quite easily, and they use a common layout so it's not hard to keep them in sync.</div><div><br></div><div>Obviously, the app was also made using bootstrap, so the look/feel was consistent all around, YMMV.</div><div><br></div><div>Slate is also a great option inside a rails app <a href="https://github.com/tripit/slate" target="_blank">https://github.com/tripit/slate</a> , but mostly for technical docs.</div><div><br></div><div>Searching, if you have everything on one page, is just a matter of hitting Cmd-F :)</div><div><br></div><div>Cheers,</div><div><br></div><div>Alex</div></div><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Thu, Apr 23, 2015 at 1:57 PM, Simon Morley <span dir="ltr"><<a href="mailto:simon@polkaspots.com" target="_blank">simon@polkaspots.com</a>></span> wrote:<br></span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5"><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>
<br></div></div>_______________________________________________<br>
Chat mailing list<br>
<a href="mailto:Chat@lists.lrug.org" target="_blank">Chat@lists.lrug.org</a><br>
Archives: <a href="http://lists.lrug.org/pipermail/chat-lrug.org" target="_blank">http://lists.lrug.org/pipermail/chat-lrug.org</a><br>
Manage your subscription: <a href="http://lists.lrug.org/options.cgi/chat-lrug.org" target="_blank">http://lists.lrug.org/options.cgi/chat-lrug.org</a><br>
List info: <a href="http://lists.lrug.org/listinfo.cgi/chat-lrug.org" target="_blank">http://lists.lrug.org/listinfo.cgi/chat-lrug.org</a><br>
<br></blockquote></div><br></div>
<br>_______________________________________________<br>
Chat mailing list<br>
<a href="mailto:Chat@lists.lrug.org">Chat@lists.lrug.org</a><br>
Archives: <a href="http://lists.lrug.org/pipermail/chat-lrug.org" target="_blank">http://lists.lrug.org/pipermail/chat-lrug.org</a><br>
Manage your subscription: <a href="http://lists.lrug.org/options.cgi/chat-lrug.org" target="_blank">http://lists.lrug.org/options.cgi/chat-lrug.org</a><br>
List info: <a href="http://lists.lrug.org/listinfo.cgi/chat-lrug.org" target="_blank">http://lists.lrug.org/listinfo.cgi/chat-lrug.org</a><br>
<br></blockquote></div><br></div>