GT Release Manuals

1
GT Release Manuals

• Cristina Williams, ISI/USC
• plus all GT committers
• cristina_at_isi.edu

2
Goals of the Project

• Provide information about technologies in the
  Globus Toolkit that developers, admins and
  end-users need to use GT.
• Make sure information is complete and more easily
  digested.
• Assist project committers with getting their
  information into the appropriate format edit,
  copyedit as needed.
• Maintain globus.org and dev.globus

3
Relationship to Other Globus Projects

• Related to all Globus Projects that are in the
  Globus Toolkit.

4
Current Work

• Maintaining release notes and documentation for
  3.2, 4.0 and current development releases
  (4.1.x), www.globus.org and the wiki,
  dev.globus.org.
• Analyzing 4.1.x docs to see where information can
  be more complete, clearer, more easily
  scannable/digested online for 4.2.0.
• Adding how to indexes (that directly link to
  information about doing common/important tasks)
  as well as back of the book indexes for each
  project.

5
Planned Next Steps

• Release notes, documentation and website updates
  for 4.1.2 and 4.0.5.
• Bubble up topics to TOC while still providing
  user/admin/dev guides.
• More complete top-level admin guide
• Re-org of info/ and security/ sections for 4.2
• Top-level Cookbook/Recipes, especially those that
  incorporate multiple projects
• Modular DocBook/olinks
• Encouraging input from user communities

6
Critical Issues

• Need to supplement reference material with higher
  level docs.
• Because of lack of resources, need to encourage
  outside contributions wikis are problematic
  gdp didnt really take off what other options?

7
Other Thoughts

• Feel free to file documentation bugs with ideas
  and suggestions as well as doc issues.
• Encourage discussion on gtmanuals-dev_at_globus
• need to advertise gtmanuals-user_at_globus somehow
  (?)
• Dont let DocBook intimidate primer (for your
  reference), assistance. Templates include
  starter code for you that is relatively easy to
  parse (ltparagt). If nothing else, include text in
  appropro files and I can get the code in final
  shape. Can also customize for your project.
• When in doubt, email me cristina_at_globus