Hi, all. I'm the writer working on the Groups.io documentation.
Thank you for the comments on the owner/moderator reference doc
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
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
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
Groups.io two years ago this February, and we couldn't be
happier that we did so!