Current Status

The docs team has voted that for now (and possibly never), trailheads will not be implemented. Rather, an effort is going to be made to assign editors and clean up the documentation area. Part of this effort will be aided by changes to the UI for the Documentation section of Plone.org. See proposed revision above.

Moreover, the topics that were listed as proposed trailheads will be examined to determine if documentation needs to be written for those topics using the structure established on this planning site. An example "trailhead" documentation that will be regigged into a standard tutorial is located here: setting up a development environment.

Possible discussion of branding "Start Here / Overview" docs in the future. - May 13, 2008

Additionally, we have started collecting a list of third party docs to help us identify gaps in our current documentation.  

Recent Updates

• Cleaned up this page and the Requirements list and updated IA Docs History , to reflect closing out PSPS #7836
• Agree to abandon trailheads in favor of focusing on recruiting topic editors to clean up exisintg IA
• Notes of IRC Meeting on Docs IA 08-04-17 : Agree to focus on refining existing IA & try out trailheads as possible supplemental navigation option
  

Next Actions

• Requirements list : Please revise
  
• Assign editors : SteveM and JoAnna will coordinate to assign editors to the individual areas of the plone.org docs section. Planning session coming to establish best practices.
• Editor best practices : Determine the conventions that editors will follow when updating / tagging documentation. Style guidelines, etc.
• Plone Conference 2008 Sprint : TBD
• Trailheads to Tutorials : Evaluate trailheads and identify if they suggest that new documentation is needed
  

+++++++++++++++++++++++++

See also

• IA Docs History
• IRC meeting on Docs IA & Notes of IRC Meeting on Docs IA 08-04-17
• Survey results
• Morons Guide Discussion
  
• PSPS #7836
  
• Plone Documentation Card Sort : Results of the July 2007 DocComm