Documentation is Hot

Post on 01-Nov-2014

2.616 views 0 download

Tags:

description

Slides from my Documentation is hot presentation at Drupalcon DC. http://dc2009.drupalcon.org/session/documentation-hot

Transcript of Documentation is Hot

Documentation is Hot

http://www.flickr.com/photos/chubbybat

What are docs?

http://flickr.com/photos/thebristolkid

- Drupal.org- API- UI

The main thing we think of: Drupal.org handbooks

The main thing we think of: Drupal.org handbooks

We also have docs in code:api.drupal.org - taken from comments for functionsUI text inside Drupal admin - in a hook_help function

We also have docs in code:api.drupal.org - taken from comments for functionsUI text inside Drupal admin - in a hook_help function

We also have docs in code:api.drupal.org - taken from comments for functionsUI text inside Drupal admin - in a hook_help function

We also have docs in code:api.drupal.org - taken from comments for functionsUI text inside Drupal admin - in a hook_help function

Being a team

http://flickr.com/photos/emurray

- Everyone can edit and review: if you help with docs you are on the team- Doc admins have additional responsibilities but you don’t need them to be “on the team”

http://www.flickr.com/photos/appaloosa

Accomplishments

- Getting Involved guide- open editing- Reorg the theme guide* the big win is that we are opening up and working together rather than in isolated tasks

http://www.flickr.com/photos/druclimb

The road ahead

- New Help system linking code and d.othere is a patch that will let us make a Documentation module for fulldocs in your Drupal site, and then have it sync with D.o pages- Internationalization

Redesign - lots of things still need to be defined, organized and built

http://www.flickr.com/photos/thomashawk

Knight Foundation is funding worldwide Drupal documentation sprintsDidn’t know if we had the money so four companies pledged to fund as a back up

http://www.flickr.com/photos/thomashawk

Knight Foundation is funding worldwide Drupal documentation sprintsDidn’t know if we had the money so four companies pledged to fund as a back up

http://www.flickr.com/photos/froboy

Getting to work

We need a full range of helpClick that edit tabJoin the discussionTeach others

http://www.flickr.com/photos/froboy

Getting to work

Drupalcon Doc SprintSaturday, March 7

9 am - 5 pmRoom 154

We need a full range of helpClick that edit tabJoin the discussionTeach others

Addison Berry (add1sun)http://drupal.org/user/65088