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

  1. Assemble links to all extant documentation
  2. 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)
  3. Determine what needs to be updated
  4. Update, clarify and restructure the g.d.o documentation section: https://drupal.org/getting-involved-guide/groups
  5. Link to and publicize this documentation for group maintainers, including in welcome messages

Comments

rootwork’s picture

Here's a list of some existing documentation:

rootwork’s picture

Issue summary: View changes
rootwork’s picture

Here's a list of missing documentation (at least I haven't been able to find it):

  • 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 post a link to an RSS feed for a group. Is this still possible? All of the group pages say "Subscribe with RSS" in plaintext (no link).
  • 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)
mgifford’s picture

I like this initiative. Also quite important to review all this for when we consider upgrading Drupal 7!

rootwork’s picture

Issue summary: View changes
cedewey’s picture

Issue summary: View changes
cedewey’s picture

Issue summary: View changes
rootwork’s picture

Issue summary: View changes
rootwork’s picture

Issue summary: View changes
cedewey’s picture

Issue summary: View changes
rootwork’s picture

Issue summary: View changes
cedewey’s picture

Issue summary: View changes
rootwork’s picture

Issue summary: View changes
rootwork’s picture

Issue summary: View changes
cedewey’s picture

Status: Active » Closed (fixed)

We've cleaned up the documentation for the items outlined. The requests for item 2 have been moved to their own distinct issues. Closing this.

rootwork’s picture

Issue summary: View changes