> I've updated the PDF
> version of the style guide here for further review:
> http://opensolaris.org/os/community/documentation/files

Excellent, thanks. :-) Does this mean I have to go all the way back to the 
beginning? Do not pass Go, do not collect $200? ;-)

> -Ineffective page breaks, fixed on pages 84 and 101,
> and by sheer luck, the 160/161 page break is also
> fixed in this version. Rainer, already up to page
> 160?!! You rock.

Aw, shucks. You have to know that I cheat. University taught me how to 
proof-read a document for formatting, etc. quite quickly. In terms of content, 
it has been getting into my fore-brain (allowing me to catch certain types of 
things), but not the hind-brain. :-) The hind-brain requires muuch more 
methodical reading.

> Also, for those who want to know,
> 'AI' is acronym-speak at Sun for an action item, or

Now how did I know that already? Spooky.

> -New Chapter 6: 'Writing Conceptual Descriptions' on
> page 125. I've tried to distill Brendan's excellent
> ideas for a new chapter here, please review the
> outline I've put together and pile on. Any and all
> contributions of text/content are welcomed.

In other words, let it sink into the hind-brain?

One thing I haven't seen yet (and, not being there yet, am assuming is covered 
in "General Word Usage") is commonly misused/abused words. This would cover 
such things as "you log in to a computer at the login prompt", rather than 
"login" being the verb and the noun. I could create a list as long as my arm, 
I'm sure. On the other hand, is this really a matter to cover in a Style Guide? 
Hmm... It's just one of those things that picks my gourd.

Rainer
Back to page 1 (or is that i?).
This message posted from opensolaris.org

Reply via email to