Hi, A while ago I figured that the ServiceMix documentation could use an upgrade. Instead of fixing everything I took the chance to experiment with some suitable frameworks like Middleman, Jekyll and Sphinx.
The first two did not really made thing easier but Sphinx (http://sphinx-doc.org/) seems like a big improvement. It is beïng used in a lot of non-python projects these days so it should lower the learning curve an effort to contribute documentation. I started out with the well known theme provided by readthedocs.org (https://github.com/snide/sphinx_rtd_theme) and added some custom functionality like an terminal window in CSS that should replace the screenshots in our current documentation. Just to test I ported the first two guides of the ServiceMix documentation. You can find the project at https://github.com/wimve/smx-doc-sphinx and a html build at https://dl.dropboxusercontent.com/u/1528761/smx-doc-sphinx/index.html Let me know what you think! If this is considered to be an improvement I'll continue to port the rest of our guides. Regards, Wim Verreydt
