Ok, didn't get to do as much last night as I wanted, but did come to the conclusion that Xml even Xml-lite documentation like the Gentoo stuff can be pretty heavy for content creators. The doc team can clean it up, but that can lead to some very ugly lag times in the future. Specially if we actually get rolling on this and the content creators become prolific. Every little change is going to require multiple iterations of manually syncing the docs from the "plain" text of the creators to the distributable Xml formats.
Reading through the rest of the postings I've was trying to think of a very lite mark-up that was easily transformable, and I thought of YAML. Very, very lite. Can be tranformed relatively easily to Xml. I still haven't looked at reST, but we would still have to write the tranformation tool from rest to Xml, and I don't know if that would be easier to do from reST2Xml, or yaml2xml. Ian? Aaron? I can go either way for the original, but there needs to be a way to take the "original" content and transform it to Xml, for all the further transformation so as to be able to utilize Xslt. As far as doc writing on Windows / OS X it isn't an issue there are several tools for Xml / Xsl tranformations on both platforms. For OS X, you might want to take a look at the fink packages ... I had an iBook for a little less than a year, and fink put my most used Linux tools on my OS X box. If we can agree on a process, I'll gladly write up the first draft of the "Howto write webware Docs / Articles? in 5 minutes or less" document. So do we: (1) : reST --> reST2xml --> Xslt --> ( HTML / PDF / ... etc ). (2) : YAML --> yaml2xml --> Xslt --> ( HTML / PDF / ... etc ). Any input appreciated. The weekend is coming up, and I can commit to working on the first draft this weekend. Anybody want to collaborate over IM / or email off list ? Ray ------------------------------------------------------- This sf.net email is sponsored by: Influence the future of Java(TM) technology. Join the Java Community Process(SM) (JCP(SM)) program now. http://ads.sourceforge.net/cgi-bin/redirect.pl?sunm0004en _______________________________________________ Webware-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/webware-devel
