Comments have been closed for this post.
Nemesis Design
Hello, my name is Federico Capoano,
I enjoy developing cutting-edge websites
and working with creative people.
Battlemesh test docs
29th July 2015 in Thoughts Tags: battlemesh, event, wireless-community
This is going to be my fourth battlemesh!
I was not satisfied with how the test results were published so I volunteered on this task to help out.
I just finished the first version of the Battlemesh Test Docs.
I hope we'll use it as a baseline for ongoing improvement and start to publish human readable documentation and results at the end of each year edition.
The documentation source format is reStructuredText and it's hosted on Github while the browsable website is hosted on readthedocs.org.
The repo structure is prepared to host the documentation and the results of multiple battlemesh editions, starting from the v8 edition, although past editions can be added if anyone will volunteer to do that.
I find this kind of solution much better than wikis because of the several advantages it gives:
- the documentation can be built easily in different formats: HTML, PDF; EPUB
- the documentation can be built offline
- it's possible to work on it offline
- it's possible to work on it with your favourite text editor instead of a web interface, which is likely to result in increased productivity and less time wasted fighting with wikis
- reStructuredText can be easily converted in other formats (eg: markdown)
- it's very easy to publish it on the amazing readthedocs.org
- managing and browsing translations is straightforward
- managing and browsing different versions is straightforward - even though it doesn't apply in this case (we'll likely have 1 version only which is updated over time)
"Wikis are where documentation goes to die."
— Jacob Kaplan-Moss
See you in Slovenia!
Comments
Comments are closed.
Categories
Let's be social
Popular posts
- Django Tagging Autocomplete Tag-It
- Django: FileField with ContentType and File Size Validation
- 10 Effective Business Card Design Tips
- How to setup StaticGenerator with Apache + mod_wsgi
- IE8 doesn't like 1x1px semi-transparent backgrounds
Latest Comments
“ I got very good results with this, thanks for sharing. ”
By Yasir Atabani in How to speed up tests with Django and PostgreSQL
“ Hi Amad, for any question regarding OpenWISP, use one of the support channels: http://openwisp.org/support.html ”
By Federico Capoano in How to install OpenWISP
“ Sir please guid , i have install the ansible-openwisp2 , now how to add the access points . What is the next procedure . Please help. ”
By Ahmad in How to install OpenWISP
“ Hi Ronak, for any question regarding OpenWISP, use one of the support channels: http://openwisp.org/support.html ”
By Federico Capoano in netjsonconfig: convert NetJSON to OpenWRT UCI
“ Hi, I have installed openwisp controller using ansible playbook. Now, i am adding the configurations automatically using OPENWRT devices in openwisp file by specifying shared_key so can you suggest me if I want to set limit to add configuration how can i do it? ”
By Ronak in netjsonconfig: convert NetJSON to OpenWRT UCI