Tsipi Erann wrote: After the long intro, here are my questions: 1. What is your opinion on the issue? 2. What style guide do you use/champion regarding procedure headings? 3. Do you have a good alternative to both gerunds and present simple? (one suggestion was a "How To" statement, which some style guides [Microsoft] prohibit... Do you know why they do?) The Sun style

If you were a reader of the document, what phrasing would annoy you more? Avoid that one. Although, I prefer concrete phrasing in my documentation, I like my headings to be approachable and to invite readers to read. If "Add Files to the Database" became the chosen phrase, then I would want to preface it with "How to," but "Adding Files..." also sounds approachable to me. Lauren

The idea is to tell people how to do things. A gerund is good for this. It is difficult to let translation/localization issues to determine your style to the extent that the guide may be harder to follow. _________________________________________ On 8/20/07, Tsipi Erann <tsipi.erann@gmail.com> wrote: I'm in the process of adapting/creating a style guide for a company that recently went