On Wed, Jan 14, 2009 at 9:10 AM, <[email protected]> wrote: >>>> + 1. make guide use a reasonable (wiki-like) markup, not docbook-xml. >>> >>> I think we like our docbook-xml Guide... a lot of work was put into >>getting >>> it the way it is. What objections do you have to the way it's being done >>> now? Let's discuss. > > There are several issues that I think have made wikis not sufficiently > attractive for us.
Ok, I guess I didn't make my intent clear enough. My suggestion is not to use a wiki as documentation. I think we have that already, that's fine, and it serves a different need. My suggestion is about using a different format: instead of an complicated XML vocabulary a lightweight markup language [1]. I think Textile and Markdown are the most commonly used ones. Those are best known as the raw format of wikis, that's why I called it wiki-like. That way the documentation would still be in a single place in the svn. I find that an important property as well. But it does not necessitate use of xml. Florian [1] http://en.wikipedia.org/wiki/Lightweight_markup_language -- Florian Ebeling Twitter: febeling [email protected] _______________________________________________ macports-dev mailing list [email protected] http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev
