Description

If you go to the Topics page on api.d.o for Drupal 7
http://api.drupal.org/api/drupal/groups/7

You will see that there are a number of topics that are completely empty (such as Contact updates from 6.x to 7.x) and a number that don't have a description or that don't have a one-line summary.

So the task is to clean up the topics/groups in Drupal 7:
- Remove empty groups
- Make sure each group has a one-line summary
- Consolidate some groups -- for instance, we probably don't need a separate group for the update functions for each module -- they could probably be grouped together more loosely
- Standardize topic names -- for instance, maybe all the Update Functions groups could start with the same word or phrase so they would be alphabetized together

Deliverables

A patch against Drupal 7 core that fixes these issues. The patch should be added to this issue:
http://drupal.org/node/987384
The student should also respond to any reviews of the patch, and revise until it has been marked "reviewed and tested by the community" and ideally, committed to Drupal 7's code base.

Resources

http://drupal.org/node/1354 (Standards for documentation in Drupal code. The section at the bottom, "Limitations and Hints", contains information about how to document groups/topics, and our standards for when they should and shouldn't be used.)
http://drupal.org/node/144223 (How to update API documentation)
http://drupal.org/patch/create (How to create a patch)
http://drupal.org/handbook/cvs (CVS information)
http://drupal.org/node/320 (checking out the main CVS repository)

Primary Contact

jhodgdon - Jennifer Hodgdon - you can find me on IRC or use the contact form on my user profile (there should be a link to that as I'm the author of this issue)
Drupal Issue

Drupal Issue
#987384: Topics/groups in D7 need cleanup

Task length estimate: 10 hours of work? Depends on how fast the student is.

Comments

jhodgdon’s picture

Note: If this is added as a GCI issue, let's move this to the Drupal Core / Documentation component issue queue, and close #987384: Topics/groups in D7 need cleanup as a duplicate. And I'll volunteer as mentor (obviously).

dmitrig01’s picture

Status: Active » Needs review
amye’s picture

Status: Needs review » Reviewed & tested by the community

Great resource list, clear task. Marking as RTBC.

dawehner’s picture

Project: Google Code-in » Documentation
Component: Documentation » Correction/Clarification
Status: Reviewed & tested by the community » Active
Issue tags: -gci-proposal +gci-task
jhodgdon’s picture

Status: Active » Closed (duplicate)