+1 Thanks Alysson.
> My recommendation is that we keep the OpenSolaris > style guide as is but develop a cheatsheet that's 1-5 > pages long, per Brendan's suggestion. That way, we > provide guidance for those who just want the basics > and for those who want to give a more concerted > effort. I also like Paul's suggestion to add more > information on the style guide page to help set > expectations. > > I agree with others that there's no requirement for > folks to read and take a test on the OpenSolaris > style guide before contributing to docs. > > But I agree with Richard that consistency in style > helps. In my mind, there's no question about that. > And, of course, technical accuracy is paramount. If > the content isn't technically accurate, the customer > isn't going to care how consistent the style is. > > Alysson This message posted from opensolaris.org
