[squeak-dev] Re: Documentation idea
pascal.vollmer at nexgo.de
Tue Jul 5 21:58:18 UTC 2011
Bert Freudenberg <bert <at> freudenbergs.de> writes:
> Why not use structured class comments? Seems cleaner to me than littering the
system with documentation
> methods. E.g.
> !LayoutMorph commentStamp: 'bf 7/5/2011 17:24' prior: 0!
> Collaborators: SystemWindow, MorphExtension, LayoutMorph
> Responsibilities: Lay out my submorphs in a row or column
I agree with Bert. Suggestions for the format to use in the class comment:
ASCIIDOC, Markdown, DocBook. DocBook for instance paves the way for HTML and PDF.
More information about the Squeak-dev