On 8/18/11 14:51 , Niclas Hedhman wrote:
Qi4j Gang, (OPS4J gang is added for potential feedback)
Since we need to get going on 2.0 docs, we need to decide on the tool to use.
Personally I would favor some type of "markdown" syntax, written in
ordinary text files under Git control.
GitHub itself has GFM[1] (GitHub Flavoured Markdown) which is
influence by John Gruber's markdown[2]
One advantage of using that would be that it is browsable from
www.github.com html pages. And I think it would technically be
possible to direct all http://www.qi4j.org/documentation to some area
on GitHub (need to be verified).
BUT that said, I would like to hear other ideas.
Mind you; I kind of think that any "wiki" setup (be it SiteVision or
Confluence) is outright "wrong" by definition, since it is not easily
versioned alongside the code it describes.
[1] http://github.github.com/github-flavored-markdown/
[2] http://daringfireball.net/projects/markdown/syntax
Ok, now we're talking! That looks GREAT! I'm all for it.
/Rickard
_______________________________________________
qi4j-dev mailing list
[email protected]
http://lists.ops4j.org/mailman/listinfo/qi4j-dev
