Le 14 avr. 2015 à 22:51, phil@highoctane.be a écrit :
I hate the figures not going where I want due to the LaTeX generation in Pillar.
There should be options to place it where you want. Maybe a pillar expert could answer?
As for class comments, markdown would make more sense to use when putting files under source control on git and then stored in github because filetree generates README.md files for such comments.
It makes for a nice reading there. In that respect, Pillar class comments will be more of a nuisance than a help.
I don't agree. We can use pillar inside the image AND we can also generate a README.md file from pillar doc when useful.
For generating web documentation, it is easier to provide markdown so that any web framework will be able to conver (e;g; Showdown.js and 2 lines of code).
We already have a pillar to MD converter. We will have to deal with MD time to time but you do not necessarily have to adopt it. You just need to have a good way to interact with it.