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!

Retweet

Comments

Comments are closed.

Comments have been closed for this post.

Categories

Let's be social

Popular posts

Latest Comments

  1. I got very good results with this, thanks for sharing.

    By Yasir Atabani in How to speed up tests with Django and PostgreSQL

  2. 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

  3. 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

  4. 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

  5. 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

Popular Tags

battlemesh censorship creativity criptography django event fosdem google-summer-of-code ibiza inspiration javascript jquery linux nemesisdesign netjson ninux nodeshot open-source openwisp openwrt performance photo programming python security staticgenerator talk upload wifi wireless-community