Date   

Owner/Mod manual corrections and suggestions

Duane
 

All page numbers shown are using the total pages, not the one at the bottom.
----------
pg 12
When using the menu>submenu>page section, it seems to me that an additional notation should be used.  As an example, Admin > Settings, Spam Control to refer to that section of the Settings page.  To go a step further, it could be Admin > Settings, Spam Control > Announcement-Only Group for an area within that section.
----------
pg 15
Change "Tip: If you want to promote your group, use appropriate keywords in the group title so..." to "... keywords in the group title or description so..." in the Group Title section as well as in the Group Description section.
----------
pg 22
The indicated link for "Viewing and managing your group’s storage space" is not active.
----------
pg 23
The indicated link for "Email Delivery" in the second bullet point is not active.
----------
pg 27
Under Wiki Settings, Permissions, there should be a Note:
Note: Wiki pages can be restricted to moderator modification when created.
----------
pg 28
Email Delivery, Full Featured Digest
Due to the recent change, "Any messages that remain at the end of the day are sent as the final (or only) digest of the day." should be changed to "Any messages that remain at 6 AM local time are sent as the final (or only) digest of the day, if a digest has not been sent within the last 6 hours.
----------
pg 31
Overview, 3rd sentence, typo - "...having an member notice..." should be "...having a member notice..."
----------
pg 32
Include a link to an example Direct Add Notice?
----------
pg 33
For clarity change "When the notice is created, a Guidelines entry automatically appears on the group’s home page." to "...appears on the left menu of the group’s home page."
----------
pg 33
Email Subject bullet.  Change from "Enter a subject line that will appear in the message in the group archive, if the notice is emailed monthly to the group." to "...will appear in the message when emailed, either to the group or an individual."
----------
pg 34
Locked Group notice.  Add:
Note: Only paid groups may be locked.
----------
pg 35
Link to an example Welcome Notice, possibly the default that's automatically created?
----------
pg 36
Sending invitations to join the group
item 4 - format of email address may be:
<name> email@... or email@...
----------
pg 37
Under "To cancel and remove invitations", item 2, add note:
Note:  If you do not cancel/remove an invitation, it can be used at any future date.
----------
pg 38
The badge is missing for Moderate First
----------
pg 38
several places, the indicated link for "posting privilege" is not active.
----------
Pg 38
NMM badge, "...posts (1, 2, 3, or 4) required before..." should be changed to "...posts (1, 2, 3, or 4) remaining before..."
----------
pg 40
at the bottom, "The note will be saved in the member’s record, which will be retained..." needs to indicate that Past Members are only available to paid groups.
----------
pg 46
Handling an individual pending message, Edit, Note, "...(however, it does not prevent other moderators from taking action)." should be changed to "...moderators from taking action online)."
----------
pg 47
item 4, "Approve & Unmoderate Senders: Approve the selected pending messages and take their senders off moderation." should be "...messages and change their senders to Use Group Moderation Setting."
----------
pg 51
item 5, "Save Without Sending: Use this button if you want to just save the edited message in the archive without emailing it to group members." change to "...without emailing it to all group members and a copy will be sent to the original poster."
----------
pg 51
near bottom, indicated link for "pending group members" not active
----------
pg 52
Receiving and viewing messages sent to the owner email address, bullet 2, "...to list all messages that have been sent to the owner email address." should be "...messages that you have sent..."
----------
pg 53
Under "Managing hashtags", Overview, for completeness, "...hash (or pound or number sign)..." should be "...hash (or pound, number sign, or octothorpe)..."
----------
pg 55
Section "Usage settings on individual hashtags" typo "...Use by Use by Mods Only..." should be "...Use by Mods Only..."
----------
pg 63
Under "Viewing your group’s storage limit and current space usage", can also see usage by going to https://groups.io/g/[groupname]/usage
----------
pg 64
Under "Adding an email integration", item 3, "Hashtags: Enter any hashtags (up to five) that you..." should be changed to "...(up to four, plus the automatic #email)..."
----------
pg 65
Under "Adding a feed integration", item 3, "Hashtags: Enter any hashtags (up to five) that you..." should be changed to "...(up to four, plus the automatic #feed)..."
----------
pg 70
"Groups.io gathers the selected data into a compressed zip archive and, generally within 10 minutes, sends you an email message with a link to the data file." should have added "...link to the data file that is valid for 24 hours."
**********

Hope I'm not being too nit-picky!

Duane


Re: Overall style points

Kristen James Eberlein
 

Nina, many thanks for your work on the documentation. I found it very useful.

Just a few comments:

  • Consider adopting a style guide and sticking to it. There are several widely used in the industry, including Microsoft Manual of Style and IBM Style Guide. The latter is my personal favorite and what I most often recommend to clients.
  • Sentence-style headings are best. All usability studies (dating back to the 1950s) show that it is more readable than the alternatives. If the headings are not standing out from the text, that's a reason to adjust how the headings are styled, for example, font size or color or a bottom border.
  • PDF bookmarks would be wonderful and make the document much more usable, but I don't know if Google docs can accommodate that :(

I moved a group (DITA Users) from Yahoo! to Groups.io last fall, and I am extremely happy with the platform. And BTW, lots of technical communicators in our group!

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 3/10/2020 7:09 PM, Nina E wrote:

Hi, all. I'm the writer working on the Groups.io 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!

Regards,
Nina

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!


Re: Feedback about documentation: Kudos!

Nina E
 

Thank you so much, Kris!

- Nina (the writer)


Re: Glossary?

Nina E
 

Hi, Bill. As I mentioned in another post, I'm using Google Docs to write the Groups.io documentation. I put the glossary in a document of its own to avoid duplicating it in both the owners/moderators reference doc and the members/reference doc, but then I discovered that linking between Google Docs is...less than ideal. :-(  Rest assured that Google Docs will NOT be the final repository for the official Groups.io documentation. Mark and I (but mostly Mark :-) ) will work on how best to publish the documentation in PDF and online/HTML form such that the links will work.

I'm using the current Groups.io help as well as a lot of info from GMF (especially the wiki) and Beta as resources for the content in the documentation, so you will see some duplication for a while. By the way, huge thanks to all of you who have contributed to those resources over the years!

- Nina


Re: The description of Time/Date controls in Default Sub Settings is wrong

Nina E
 

Thanks, Shal! Mark and I are working on clarifying that settings page and correcting the information in the documentation.

- Nina


Re: Overall style points

Nina E
 

Hi, all. I'm the writer working on the Groups.io 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!

Regards,
Nina

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!


Re: manual v1 Group Email Address error

 

On Sun, Mar 8, 2020 at 11:28 AM Duane <txpigeon@...> wrote:
On Sun, Mar 8, 2020 at 11:57 AM, Nina E wrote:
I asked Mark about the character limit for the group email address, and he told me 34. :-)
Thank you.  I can't believe Mark made that mistake over 2 years ago and no one caught it. ;>)  I did a quick test and verified that 34 is correct.

Duane, I've been making mistakes for much longer than two years. :-)


Mark 


Re: Overall style points

Mark Murphy
 

I agree with section numbering in the main body and TOC, preferably in an outline format like:


Re: manual v1 Group Email Address error

Duane
 

On Sun, Mar 8, 2020 at 11:57 AM, Nina E wrote:
I asked Mark about the character limit for the group email address, and he told me 34. :-)
Thank you.  I can't believe Mark made that mistake over 2 years ago and no one caught it. ;>)  I did a quick test and verified that 34 is correct.

Duane


Re: manual v1 Group Email Address error

Nina E
 

Hi, Duane. I asked Mark about the character limit for the group email address, and he told me 34. :-)

- Nina (the writer)


Re: Overall style points

Bill Hazel
 

On Sat, Mar 7, 2020 at 10:10 PM, Shal Farley wrote:
Perhaps like a Wiki of its own, but with only Groups.io having edit permission.
I like this idea. Then it is easy to search and to link to from other groups.io. I really like linking to the source vs copies of it.
An advantage of the wiki is that all the currently linked to material (see would have their own wikipage to link to.
Also, instead of dealing with multiple static copies we would always be looking at a dynamic current version.

Bill


Overall style points

 

Mark,

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

2) How about section numbers? In both the TOC and the body. Though they might be subject to change with each major revision I think they will help in citations to the manual. In the HTML version maybe supplement that with hover permalinks similar to those in the Help page - but keep them the same as the TOC links (if practical) and as short as practical, even when on a Header 2 or Header 3.

3) Will this be all one big HTML page? I'm a little ambivalent. That does enable browser-based search, but it seems like it could be a bit much. I think I'd prefer it broken into chapters (or smaller) with a dedicated search. Perhaps like a Wiki of its own, but with only Groups.io having edit permission.

4) PDF Bookmarks, please! I don't know what tool Nina is using, but hopefully its export to PDF function can be coerced to emit bookmarks. In MS Word that's in an option pop-up you open from the File dialog when you Export. In Acrobat Reader these Bookmars show up as a sidebar on the left with clickable links to go directly to headings.

5) For the PDF pay attention to page breaks. This goes beyond simple orphan/widow control in paragraphs (which seems to be mostly under control); there needs to be more use of Keep With Next (or whatever it is called in Nina's authoring tool) to avoid having headings orphaned at the bottom of a page; examples on pages: 12, 13, 15, 24, 26, 45, 52, and 73. Or widows at the top of a page; examples: 4, 7, 11, 12, 20, 54, 66, 69, and 71.

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

Shal


The description of Time/Date controls in Default Sub Settings is wrong

 

Mark,

In "Setting default subscription options for group members", p 18-20, each of Timezones, Time Display, Date Display and Monday Start ends with the note:
Note: A change to this setting applies only to new members of the group; a change here does not affect existing members.
That text actually applies to all of the other settings on this tab of the Settings page, not to those. This note should be placed prominantly at the beginning of the section, not duplicated for each of the non-time settings.

Timezones, Time Display, Date Display and Monday Start apply only to new Users of Groups.io - people whose email address, prior to joining this particular group, had not joined another group or had otherwise set those controls in their Account settings.

The placement of these settings was topic #71740860 recently in Beta, and their exact operation has been a FAQ in GMF for some time.

Shal
(And yet, somehow, I'm not finding it in our Wiki. Gotta go fix that.)


Re: Owners and Moderators Reference - Review Comments

 

Andy,

* Also on p22, the bullet point spacing for the notes in the Message
Footer section are not consistent with those on the previous and
following pages
That one I count as a good thing. In a way it is a different kind of list as its elements are short phrases, not paragraphs. There are more examples of this sort of thing.

BTW, it took me a while to figure out the Adobe page numbers (I was reviewing a printed copy). They are ten higher the document page numbers owing to the TOC and other content prior to page 1.

Shal


Re: Owners and Moderators Reference - Review Comments

Andy Wedge
 

On Sat, Mar 7, 2020 at 05:00 PM, Bill Hazel wrote:
I only noticed the Glossary file link mentioned in my post.
There are quite a few on p17 (Adobe reader page number) under the Member Directory Visibility heading and others through the document.

I understand that these files might not be ready for prime-time but if not, maybe they should all be uploaded to the files section here and linked to. If they also need possible tweaking you already have volunteers - anyone part of this group - who have already signed up.
Yes, a good idea.

Andy


Re: Owners and Moderators Reference - Review Comments

Bill Hazel
 

On Fri, Mar 6, 2020 at 10:32 PM, Andy Wedge wrote:
There are lots of hyperlinks that point to a Google Drive account. Is it really the intention to force readers to use a cloud storage solution to get extra info?
I only noticed the Glossary file link mentioned in my post.
I understand that these files might not be ready for prime-time but if not, maybe they should all be uploaded to the files section here and linked to. If they also need possible tweaking you already have volunteers - anyone part of this group - who have already signed up.

Bill


Feedback about documentation: Kudos!

Kristen James Eberlein
 

Kudos! I gave it a quick look, and then immediately used it perform some tasks -- merging and splitting topics -- that I had not quite been comfortable with. The documentation gave me all the information that I needed.

Kris


Re: Owners and Moderators Reference - Review Comments

Andy Wedge
 

In addition:

  • At the top of p22 (Adobe reader page number) - the text Viewing and managing your group’s storage space is underlined and coloured as though it's a link but it doesn't point anywhere
  • Also on p22, the bullet point spacing for the notes in the Message Footer section are not consistent with those on the previous and following pages
Andy


Glossary?

Bill Hazel
 

According to the PDF on page 2, we are directed to "See the Groups.io Glossary for a list of common terms used in Groups.io and their definitions." but to actually view it requires access to a Google Docs account.

It would seem that this should be readily available to every member of Groups.io.

I looked at the beta wiki and the "Help" at the top of the page, the 2 places I would most expect to find it (I also looked at the Groups.io webpage but it didn't have a wiki) I also checked GMF wiki with zero result but that isn't "Official" anyway.

Is the Glossary the same as Definitions on the "help" page? If so, one of the titles could be changed so the same thing is always called the same thing - a wayfinding technique I learned over 10 years ago at Boeing.

Bill


Owners and Moderators Reference - Review Comments

Andy Wedge
 

Hi Mark,

on my first quick scan I can see:

  • There are lots of hyperlinks that point to a Google Drive account. Is it really the intention to force readers to use a cloud storage solution to get extra info?
  • On p12 (Adobe reader page number) - remove mailto: link from +owner example
  • The limited number of graphics look fuzzy. For more visually oriented people, more higher resolution graphics would help.

Regards,
Andy

361 - 380 of 383