[LRUG] [Help] Hosted Documentation Recommendations

[Simon Morley]

Hello

Thanks everyone for the suggestions so far.

Seems like an odd middle-ground we're looking for. And there's clearly very
few solutions. Are we alone?

--

Matt, I agree - going the SaaS route will probably hold us back long-term.
I'm just spending more time worrying about docs than shipping code. And
that ain't good.

Glenn - I'm trying your elev. suggestion now. Thanks. Shame it's yet
another widget to install.

Alex - slate is actually what we're going to move our api docs to. What's
Cmd-F? ;)

Nicholas - Middleman does look nice, I try that later.

Sasha - thank, forgot to include that first time. Too nerdy for our
customers but will have another look.

To the rest of you, thank you :)

S






Simon Morley
Big Chief | PolkaSpots Supafly Wi-Fi

simon at PolkaSpots.com
Linkedin: I'm not on it, it sucks
020 7183 1471




On 23 April 2015 at 14:52, Matthew O'Riordan <matthew.oriordan at gmail.com>
wrote:

> We use Nanoc + Textile because we found whilst Markdown is really nice and
> simple, it unfortunately did not provide us with sufficient control when we
> needed more advanced features.
> Unfortunately Simon, we found that there was not silver bullet solution
> out there and ended up having to build our own as we went along.  Looking
> back, I think if we had used a SaaS solution, we'd have been very limited.
>
> Matt
> ably.io
>
> On 23 Apr 2015, at 13:33, Glenn Gillen <glenn at rubypond.com> wrote:
>
> Does http://elev.io do what you need?
>
> -
> Glenn
> Founder - Glu IO
> http://getglu.io
>
> Would it be quicker and easier to continue this discussion on the phone or
> via Skype? Or would you like to grab a coffee together? Then just book a
> time that works in my calendar: http://glenngillen.com/calendar
>
>
> On Thu, Apr 23, 2015 at 9:57 PM, Simon Morley <simon at polkaspots.com>
> wrote:
>
>> Hello All
>>
>> *What do you use for your product documentation?*
>>
>> We just launched a new service and our docs were foolishly / typically
>> left to the last minute.
>>
>> 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.
>>
>> In desperation, we've chucked them on readme.io. However, words cannot
>> describe how terrible readme is. Avoid. Plague. Although it is
>> superficially pretty:
>>
>> http://docs.cucumbertony.com
>>
>> We already use Intercom for support so we need none of that. We have our
>> api documentation on apiary (http://docs.polkaspots.apiary.io/#) which
>> is awesome.
>>
>>  We just a place for the end-user, customer facing, help-me style docs.
>>
>> *Stuff we tried:*
>>
>> - Zendesk - good support system, crap docs, terrible community aspect.
>> - Freshdesk - support orientated.
>> - Help Scout - ok but more about support. Ugly.
>> - Help Juice - OMG VPL expensive.
>> - Readme.io - genuinely made me irate.
>> - Desk - seemingly all about support.
>> - Atlassian - the peeps writing them couldn't understand it.
>> - Github pages - fabulous but needs attention and same issue as Atlassian.
>> - Userdeck - no idea what it does still.
>>  - HappyFox - v basic apparently, didn't try.
>> - kayako - too complicated to set up.
>>
>> We need something simple. With basic search. And it needs to be pretty.
>> And easy to use.
>>
>> If this magical beast doesn't exist, it should. I'd even write something
>> with some of you.
>>
>> Great product, shoddy docs. Not cool.
>>
>> Help?
>>
>> S
>>
>>
>> Simon Morley
>> Big Chief | PolkaSpots Supafly Wi-Fi
>>
>> simon at PolkaSpots.com
>> Linkedin: I'm not on it, it sucks
>> 020 7183 1471
>>
>>
>>
> _______________________________________________
> Chat mailing list
> Chat at lists.lrug.org
> Archives: http://lists.lrug.org/pipermail/chat-lrug.org
> Manage your subscription: http://lists.lrug.org/options.cgi/chat-lrug.org
> List info: http://lists.lrug.org/listinfo.cgi/chat-lrug.org
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lrug.org/pipermail/chat-lrug.org/attachments/20150423/294d5b91/attachment.html>