>> 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 :)
Locked
