Le 14 avr. 2015 à 22:51, [email protected] 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.

Attachment: smime.p7s
Description: S/MIME cryptographic signature

Reply via email to