At work I was looking for a way to write project documentation for several non-public projects. It was important for me to have a system that was versioncontrolled in GIT, written in easy to understand formatting for both technical and non-technical personel (markdown) and makes publishing effortless. The resulting documentation should also be easy to access for our clients, without resorting to getting them all an account.
In a presentation by Stephen Hay at the Mobilism 2012 conference I was pointed to dexy, an advanced tool for writing documentation in a lot of different languages, markdown being one of them. In this post I will describe how to setup dexy, and combine it with GitLab's webhook system to create a selfbuilding documentation system.
I'm a big fan of Vagrant but all our developers use MacBook Air's with 4GB memory and lots of different projects at the same time it's just a pain to use Vagrant.
We compensated this by using a few staging servers and using Vagrant if there are issues at this level (almost never btw)
And there is nothing in the result that has anything to do with ruby, just chef and the recipes are in ruby. We use it for setting up our dev environments and servers for PHP websites. Although we use Capistrano for the actual site deployment and not Chef.
And do not forget to register for the referral program!