Hi--

Many thanks to Rainer for reviewing the last set of updated chapters of the 
OpenSolaris style guide.

I have finished incorporating the changes into Chapter 4 of the style guide. 
The changes are relatively minor.

If you have the time and the inclination, please review the changes, which are 
marked with change tracking. Any feedback is welcome. To access the chapter, go 
to:

http://opensolaris.org/os/community/documentation/reviews/

I'd appreciate receiving your feedback by June 12.

I'll summarize the changes here. If you would like to know more about why a 
specific change was made, feel free to ask. I'd be happy to provide details.

The updated chapter includes:

* New guidelines
* Clarification of existing guidelines
* More examples
* Bug fixes and consistency improvements

Some of the specific changes include the following:

* Removed the use of bold for key words and phrases because the
recommendation to do so has been removed from Chapter 3, "Online Writing Style."

* Removed a paragraph that explains an online help guide that is internal to 
Sun.

* Clarified the definition of the word "page."

* Changed instances of "web browser" to "browser" so that "browser" can be more 
inclusive and not specific to the web. Some applications that are not web-based 
use a browser interface.

* Refined the index.

Thanks so much for your help!

Alysson

-- 
Alysson Troffer
Technical Editor
Sun Microsystems, Inc.
 
 
This message posted from opensolaris.org

Reply via email to