PlantUML is a really awesome way to create diagrams by writing code instead of drawing and dragging visual elements. Markdown is a really nice documentation tool.
Here's how I combine the two, to create docs with embedded diagrams.
Get the command-line PlantUML from the download page or your relevant package manager.
The instructions are based on this answers.ros.org thread.
You may need the latest pip, follow the official instructions.
Install bloom:
| #How to generate debian for package foobar | |
| # Need to have install pip package stdeb | |
| PKG=foobar | |
| pip install -d . $PKG | |
| tar xfvz $PKG*.tar.gz | |
| cd $PKG* | |
| python setup.py --command-packages=stdeb.command bdist_deb | |
| #Debian is generated within deb_dist directory |
