Hi Ben, Thanks for this question, you wrote: > > I'm curious how this will effect the contribution > model. > > The above suggests to me that these documents will > continue to > maintained within the organization in the existing > SolBook formats and > converted from time to time as code drops. This > means that any changes > to these documents should be submitted as editor > style comments rather > than patches to the DocBook source. > > Can we get clarification how, if at all, this > deviates from the roadmap?
Sure, the complete plan--and we need to make this more explicit in the roadmap--is to have an import tool, so that changes to the DocBook source can be converted back to Solbook, when the contributor and original author agree that the changes are ready for the docs.sun.com version of the published book. The development of the java app that Mark mentioned will come first so we can enable community development and publishing of documents on the OpenSolaris.org site, that might be in various stages of review. So, our roadmap needs to have two items added, IMO: -HTML publishing of DocBook sources on OS.o site (phase 3) -Import tool to convert DocBook sources back to SolBook (phase 4) I don't see how this deviates from what has been put forth in the roadmap so far, and I'll work on the updates above. Ultimately, in alignment with the ON SCM plans, we will have a common source base outside of SWAN that enables true collaborative doc development, and this will be particularly interesting for new doc projects, maybe not so much so for existing and legacy documents, but who knows? It is down the road a bit, so these other tools will give us a collaborative environment until then. As an aside...The tricky part of having a large library of commercial docs for an open source project is that getting contributed content out to docs.sun.com requires the highest levels of rigor and process, sophisticated linking, etc. so we are solving for that problem first. But, that is the toughest case, and I think we'll have more folks interested in creating their own new documents that live on OpenSolaris.org or on their own sites, than folks wanting to fix existing documentation. I make that assumption based on the bugs filed so far (no one wants to work on any fixes yet), and my own personal preference to work on 'from scratch' docs rather than update existing materials. But, we are just getting started, so the bug data could be very different a year from now. Jump in here with comments to the contrary anyone. Does this help? Thanks, Michelle > > benr. > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org > This message posted from opensolaris.org
