Re: Overall style points

Nina E

Hi, all. I'm the writer working on the documentation. Thank you for the comments on the owner/moderator reference doc so far!

To address some of the points that Shal raised:

1) How about Title Case for section titles? I think that would help them stand out in the document body.

I used sentence case from force of habit because that was the standard in my last tech writing/editing job. :-) That said, because many headings contain proper nouns (names of web pages, menu items, fields, and so on), I think sentence case helps those proper nouns stand out in the headings. Also, numbering will help the headings stand out (see the next item).

2) How about section numbers?

I agree that heading numbers will help in the printed/PDF version. (I'm not convinced that heading numbers are terribly useful in online presentation, but we'll see how it goes.) I didn't include them initially because I'm writing the documentation in Google Docs (that's the approach Mark and I agreed on when I first contacted him), and Google Docs doesn't have a heading numbering feature built in. However, I recently found an add-on that does the trick, so I'll try that in the next draft.

4) PDF Bookmarks, please!

As I mentioned above, I'm currently using Google Docs, but I'm not very familiar with its export-to-PDF capabilities. Maybe there's an add-on that will add bookmarks to PDF files; I'll look around. (If anyone happens to know of such a Google Docs add-on, please let me know.)

5) For the PDF pay attention to page breaks.

For sure. I'm waiting until the final draft, so I don't have to redo too many. :-)

6) For the PDF consider using a new page for selected headings. All Heading 1 likely, and maybe all of Heading 2 as well.

Good suggestion - I'll give it a try.

Thank you again!


P.S. For the record, I own/moderate a restricted Premium group for a chorus of which I'm a member, and I serve as secretary on its board. We transferred our group from Yahoo Groups to two years ago this February, and we couldn't be happier that we did so!

Join to automatically receive all group messages.