News for hackers. Stuff that matters.

Ask HN: What do you use for internal documentation?

We currently use the Fogbugz wiki and it's horrendous. We use mediawiki for external docs and that's a bit of a pain too - lots of work to skin it, not very user friendly. We also use Google docs which is a great applicaiton but not very good at managing and organizing lots of internal documents for a team.

I'm looking for something for a small team (5 to 10 people) to very easily add documentation to that can include file attachments, formatting and includes revision history. It would be great if it was self organizing e.g. auto generated lists of recently modified, most frequently accessed etc.

I would like it to have these features out of the box along with great security i.e. it's for internal use only and has secure sign-on.

We need this for ops docs, network diagrams, documents about our security audits, tools and configurations, product specs, project plans, biz plans etc.

I'm expecting to pay for the service.

I'd love to hear what other HN members and businesses are using. Thanks!

( 14 comments | 7 points | on HN )
Re:Ask HN: What do you use for internal documentation? by justfalcon on Monday November 30, 2015 @08:30PM (#10653127)
I've used a simple wordpress wiki theme called "KnowHow" for a lot of clients, if you're looking for an easy-on-the-eyes setup that's easy to maintain. I've used it for small business's sites and I've also used it to set up an internal KB for a nation-wide shoe retailer while working in their IT dept... with a couple tweaks and plugins you can setup some pretty decent workflows and approval steps for authoring.
Re:Ask HN: What do you use for internal documentation? by brianjking on Tuesday December 01, 2015 @10:42AM (#10656137)
Do you have any examples? link to repo? Thanks!
Re:Ask HN: What do you use for internal documentation? by brianjking on Tuesday December 01, 2015 @10:41AM (#10656125)
I'd love to use Confluence, however, it's incredibly resource intensive and requires a lot of admin time. Furthermore, JAVA is something I know little to nothing about so it makes me a bit uncomfortable.

For distributing documentation I really enjoy using MkDocs (http://mkdocs.org) or Daux.io (http://daux.io) as both are written in markdown and then generated into responsive HTML/CSS sites that can easily be versioned with Github or Bitbucket or any other version control application.

Re:Ask HN: What do you use for internal documentation? by brianjking on Tuesday December 01, 2015 @10:46AM (#10656173)
While the generating & updating of documentation and pushing to a server may be "too technical" MkDocs makes it pretty easy to deploy to Github Pages or generate the HTML to a static directory that can be deployed to a private location.

You could have a simple git hook that looks for new commits and re-publish HTML files and then deploy those with something like Deploybot (http://deploybot.com/).

In terms of authoring the content it's simple Markdown formatting, pretty simple to get the hang of. However, it lacks the file upload functionality you're asking for.

Re:Ask HN: What do you use for internal documentation? by ruraljuror on Tuesday December 01, 2015 @11:03AM (#10656349)
I don't use it, but I've heard great things about Read The docs: https://readthedocs.org/

I believe the documentation for the hangfire library uses it: http://docs.hangfire.io/en/latest/#

Re:Ask HN: What do you use for internal documentation? by brianjking on Tuesday December 01, 2015 @10:52PM (#10660822)
MkDocs (http://mkdocs.org) has a readthedocs theme and can actually be deployed to the readthedocs service. It's a bit easier to get setup on a system for the initial documentation to be produced IMHO.
Re:Ask HN: What do you use for internal documentation? by citruspi on Monday November 30, 2015 @08:44PM (#10653176)
We previously used Basecamp[0] but have switched to Confluence[1] in the last month or so.

[0]: https://basecamp.com

[1]: https://www.atlassian.com/software/confluence

Re:Ask HN: What do you use for internal documentation? by eswat on Monday November 30, 2015 @11:01PM (#10653563)
What prompted the switch?
Re:Ask HN: What do you use for internal documentation? by stephenr on Monday November 30, 2015 @10:40PM (#10653513)
Given the mixed technical/non-technical nature, I'd suggest something like Gollum (the thing that powers GitHub's Wiki's) because you can allow both "in-browser" editing and (for the technically minded) local editing via the raw markdown/RST/etc files in a cloned git repo.
Re:Ask HN: What do you use for internal documentation? by rajathagasthya on Tuesday December 01, 2015 @03:29PM (#10658504)
We use Jive and it's pretty good, although my personal favorite is Confluence because you can organize a lot better there.
Re:Ask HN: What do you use for internal documentation? by askafriend on Monday November 30, 2015 @08:55PM (#10653218)
Confluence by Atlassian (we also use JIRA)
Re:Ask HN: What do you use for internal documentation? by GFischer on Tuesday December 01, 2015 @12:29PM (#10657184)
Same here, both Confluence and JIRA.

It took a lot of work from several team members to get it to the current state where most people are happy about how it works, though.

But I think you can't avoid some level of customization for any platform you choose.

A positive is that they're getting a nice ecosystem, with several interesting plugins.

Re:Ask HN: What do you use for internal documentation? by LarryMade2 on Monday November 30, 2015 @08:19PM (#10653085)
I've used dokuwiki, very friendly, not too hard to work with, you can set up ACLs user/groups, etc.
Re:Ask HN: What do you use for internal documentation? by tectonic on Monday November 30, 2015 @08:32PM (#10653135)
We have a GitHub repo that anyone can make PRs to.