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
)
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.
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.
I believe the documentation for the hangfire library uses it: http://docs.hangfire.io/en/latest/#
[0]: https://basecamp.com
[1]: https://www.atlassian.com/software/confluence
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.