Documentation best practices and strategies


Tags:

CMS: Drupal, Alfresco, Any

not scheduled

Description:

This session is for the various CMS projects to share their own general documentation best practices strategies. What works? What doesn't? What are we doing well, and what can we do better?

Topics might include something like:

  • How to balance a low bar to user participation with quality/clarity of documentation?
  • How to both define and write for all your target audiences?
  • The great debate: wikis or structured handbooks?
  • What to do with old / out-dated documentation?
  • What to do with documentation for a new version of your product?
  • Using revision control systems for documentation
  • post your other ideas as comments!

Lead by:

"in theory," no one in particular. I'd like to hold this as a general "round-table" kind of thing with representatives from the various projects' documentation teams just talk and share ideas.