along these lines is anyone working on a Markdown[1] formatter for Pharo?
PetitMarkdown <http://ss3.gemstone.com/ss/petitmarkdown.html> Yes I patched the existing parser to be more or less useful. but it was far from complete plus the old design did not really permit for the full markdown syntax :/ so damien started a new prototype which parses the basic blocks first and then goes into details.
I am probably notorious for missing class comments, but I am more motivated to write class comments if I can produce nicely formatted comments[2].
so far igor used our old parser to create the NativeBoos documentation filled with interactive links to methods and classes plus decent formatting for source code and titles
I am seriously considering including the "Metacello Scripting API doc"[3] as the class comment for the Metacello class, but you have to admit that [3] is more readable than [4].
but it still reads fairly well even in the plain text format :)
BTW, Markdown isn't the only markup syntax[5]...supporting one of the many would be sufficient..
indeed, I am somehow torn towards MarkDown (totally arbitrary choice I guess). Unless someone comes up with a very convincing argument I'd stick with markdown :)