Hi T.J - One thing that has piqued my curiosity is how is the wiki converted to a docbook format?
See other comments in line - ginnie T.J. Yang wrote: > >> From: Virginia Wray <Virginia.Wray at Sun.COM> >> Reply-To: Virginia.Wray at Sun.COM >> To: TJ Yang <tj_yang at hotmail.com> >> CC: docs-discuss at opensolaris.org >> Subject: Re: [docs-discuss] OpenSoalris Documentation tool ? >> Date: Wed, 13 Jul 2005 10:06:41 -0600 >> >> Hi TJ - >> >> What type of documentation are you interested in contributing? If you >> want to contribute to the System Administration documentation at >> docs.sun.com, currently you would work with a sponsor to add your >> contribution. > > > I am intrested to contribute "Opensolaris with TWW HPMS". > Titel in this URL http://en.wikibooks.org/wiki/OpenSolaris, should be > rename later to > "TWW HPMS with Opensolaris". > > This document will document my effort(others welcome to join) > regarding to TWW and opensolaris. > > For my understanding, Sun use FrameMaker to create document in > docs.sun.com. > But F.M. may not a good tool for opensolaris given it is not freelly > avaiable. I can't speak for all of the documentation on docs.sun.com, so you may be correct that some is done in Frame. I personally work with a version of docbook that Sun has taken and modified for it's purposes. > >> For other documentation, as far as I know there has not been a single >> documentation tool suggested, and it's a good topic for discussion. >> Currently, there is a lot of documentation scattered around the site. >> I would have to go back and look because I'm not sure if there was any >> particular tool used in creating these documents, not having worked >> with any of them. >> > > There are many model opensolaris documenation project can learn from. > 1. Python Documentation > 2. Linux LDP project > 3. FreeBSD ... Yes. I've looked the last two over. I'll look at the Python web site. Thanks. > >> Have you worked on other open source project documentation? > > > No, I don't have experienceon open source project documenation and I > don't plan > to lead. I am only intersted to participate and force myself to improve my > written English. This is great. I would be happy to help you if you have questions about writing. We haven't developed a process for documentation, so I think you could really contribute by being our first publication submission. Let me know what you think about this. Ginnie > > T.J. Yang > >> >> Ginnie >> >> >> >> TJ Yang wrote: >> >>> What is the documenation tool for opensoalris ? >>> >>> My personal first choice is DocBook and LaTex secondly. >>> and I like to suggest using this wiki as protoping place. >>> >>> http://en.wikibooks.org/wiki/OpenSolaris >>> >>> once content is set, we can convert the wiki pages to either docbook >>> or tex. >>> >>> This wiki2docbook wiki2tex approach will make documentation to >>> wider audience >>> without the contributors knowing docbook or tex syntax. >>> >>> Your comments ? >>> >>> tj >>> This message posted from opensolaris.org >>> _______________________________________________ >>> docs-discuss mailing list >>> docs-discuss at opensolaris.org >> >> >> > > -- Ginnie Wray Technical Publications UBRMO5-3128 X.78889 virginia.wray at sun.com
