Problem/Motivation
It seems like a lot of the documentation for g.d.o managers is a) incomplete or nonexistent, b) outdated, and c) scattered between several places and not easily findable.
For instance, I've been unable to figure out any way to use the provided views to create a page that displays all post of a particular type (say, Jobs) or all posts with a particular taxonomy term. There are views that imply they do this through context and arguments, but I've tried everything I can think of and it hasn't worked. Regardless, there should be guidance on how to do this. (Update: After searching waaaay back through the maintainers' group, I found instructions here and here -- in comments on questions from others about how to do this.)
Another example is the creating-new-vocabularies bug. The workaround is referred to in a few places, but exists in an issue queue of a specific module -- obviously not the most user-friendly place to find it.
Proposed resolution
Organize a documentation sprint to create a single canonical location for g.d.o maintainers to refer to. Sprint is happening here at the Community Summit at Drupalcon Austin 2014. Link this from the g.d.o maintainers group and possibly other locations (the issue queue? the "page management" section of a group?)
Remaining tasks
- Assemble links to all extant documentation
- About groups.drupal.org - in terms of documentation for maintainers, this is primarily useful for the links to policies. We should link to documentation from here.
- Participate in Drupal Groups (groups.drupal.org) - the existing, most-complete section of documentation for maintainers, specifically under organizing your group. Some of this needs to be updated, but this is where all the below should be moved to.
Roles and Responsibilities on groups.drupal.org - in addition to policies, describes a little bit what the different group admin sections are for (pages, broadcast, etc.).Moved to the documentation pagePermissions and Content flow for Groups.Drupal.org - explains who has access to which parts of group administration (among other things)Moved to the documentation pageUsing G.D.O Groups content type node - steps through a lot of the sections (especially under Pages) in detail, though it could use clarification.Moved to a documentation page.OG Vocab not available to admins of group - comment explains the workaround for creating new vocabularies.Added to Add taxonomy to your groupEditors: start your aggregating - Explains how to add a feed to your group.Added this to the documentation site- https://drupal.org/node/2278503on views and panels and taxonomy lists - Comment explains how to display nodes of a particular taxonomy term.Moved to documentation siteHow to use Pages properly? - Comment (and the one below) explains how to display nodes of a particular type.Moved to documentation site.Using Panels and Views for Your Group Homepage (and sub-pages) - Explains a lot of the views available when you create a page and add content, though incomplete and some of it is out of date.Moved to documentation site.OrganicGroups+Panels on GDO - this is an old presentation on Drupal Dojo. Unfortunately the video is no longer working (Blip deleted all their old videos). I'm not sure if this is archived elsewhere, but I bet there is useful stuff in it.Moved to documentation site.Using og_panels on groups.drupal.org - An even older presentation, also no longer available. Perhaps archived elsewhere?Moved to documentation site.
- Determine what needs to be created
- How to use the "river of news" view on a replaced home page. (The answer is to set the context with the node ID, but as far as I can tell this isn't explained anywhere.)
- How to create an ical feed for events. See the LA group events page.
- How to create or edit the RSS feed for a group. Is this possible?
- How to create panels with the "rounded corners" pane type (perhaps this functionality was removed, but I still see it on some of the older groups)
- Determine what needs to be updated
- Update, clarify and restructure the g.d.o documentation section: https://drupal.org/getting-involved-guide/groups
- Link to and publicize this documentation for group maintainers, including in welcome messages
Comments
Comment #1
rootworkHere's a list of some existing documentation:
Comment #2
rootworkComment #3
rootworkHere's a list of missing documentation (at least I haven't been able to find it):
Comment #4
mgiffordI like this initiative. Also quite important to review all this for when we consider upgrading Drupal 7!
Comment #5
rootworkComment #6
cedeweyComment #7
cedeweyComment #8
rootworkComment #9
rootworkComment #10
cedeweyComment #11
rootworkComment #12
cedeweyComment #13
rootworkComment #14
rootworkComment #15
cedeweyWe've cleaned up the documentation for the items outlined. The requests for item 2 have been moved to their own distinct issues. Closing this.
Comment #16
rootwork