Agreed. I also think there's a bit of a misconception here. Nobody is forcing anyone to read the OSG before contributing, the same as nobody forced me to pour through the SMF code before my expressing my opinion in the forum.
However, if someone wants to make a more concerted effort, the OSG is there to help them make that effort as professional and translatable as possible. To continue the above analogy, if you want to contribute code or bug fixes to the SMF code, there's an expectation that you've gone through the code base and grok it. Blogs and wikis soften the "rules" somewhat, but I think it is reasonable to expect the current PDF's written by Sun to stick around for quite some time, and hopefully be added to by non-Sun OS.o members. There should be some expectation of professionalism attempted in a 150-page PDF. This same expectation should be valid when submitting a "bug patch" to the Sun documentation. Rainer Richard L. Hamilton wrote: > Content over style, sure. But given the sheer volume of documentation > a user of OpenSolaris may have to wade through at one time or another, > consistency helps, and IMO that includes style. > > Collaborative editing tools (or wikis) may allow some to produce content > and others to refine the style. But I think that's no excuse not to read > the style guide and make a reasonable effort to comply (although I don't > know that I'd reject something because the author hadn't gotten around to > that yet). Reading the style guide takes what, a couple hours? Yeah, some > folks are very busy, but I bet they could fit that in before too many days > went by. > > Maybe that's just me. I'd rather _I_ controlled my words, or at the very > least, > if someone edited them, they convinced me why it was an improvement, so > I could learn from them and do better next time. And of course I'll read > almost > anything, even troll bait and toothpaste tubes; looking something up in a > dictionary without getting sidetracked can be a real challenge some days. > > > This message posted from opensolaris.org > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org -- Mind the gap.
