DITA Technical Communications SC Meeting

Event Description: WebEx Web Conferencing sponsored by Cisco Systems: To join the online meeting (Now from the Apple iPhone (R) and other smartphones!) ------------------------------------------------------- 1.. Go to https://cisco.webex.com/ciscosales/j.php?ED=149891257&UID=0&PW=NYmZmODYzOGJj &RT=MiMzMQ%3D%3D 2. Enter your name and email address. 3. Enter the meeting password: dita 4. Click "Join Now". To view in other time zones or languages, please click the link: https://cisco.webex.com/ciscosales/j.php?ED=149891257&UID=0&PW=NYmZmODYzOGJj &ORT=MiMzMQ%3D%3D ---------------------------------------------------------------- ALERT:Toll-Free Dial Restrictions for (408) and (919) Area Codes ---------------------------------------------------------------- The affected toll free numbers are: (866) 432-9903 for the San Jose/Milpitas area and (866) 349-3520 for the RTP area. Please dial the local access number for your area from the list below: - San Jose/Milpitas (408) area: 525-6800 - RTP (919) area: 392-3330 ------------------------------------------------------- To join the teleconference only ------------------------------------------------------- 1. Dial into Cisco WebEx (view all Global Access Numbers at http://cisco.com/en/US/about/doing_business/conferencing/index.html 2. Follow the prompts to enter the Meeting Number (listed above) or Access Code followed by the # sign. San Jose, CA: +1.408.525.6800 RTP: +1.919.392.3330 US/Canada: +1.866.432.9903 United Kingdom: +44.20.8824.0117 India: +91.80.4350.1111 Germany: +49.619.6773.9002 Japan: +81.3.5763.9394 China: +86.10.8515.5666

1. Roll Call:
   • Regrets: David Helfinstine, Paul Grosso
2. Review and accept minutes from previous meeting (22 August 2011)
   • minutes?

3. Next meeting Monday 3 October 2011 at 11 a.m. ET

4. Review actions from previous meetings:

   • http://www.oasis-open.org/apps/org/workgroup/dita-techcomm/members/action_items.php

5. Business
   1. Troubleshooting documentation
      • Continue discussion of new troubleshooting topic
        • Deep dive into info model of sections
        • Hash out whether to use shortdesc for the symptoms or some other mechanism
      • Adding a troubleshooting section to the task topic (awaiting functional spec from Gershon)
      • Adding a step-troubleshooting element to the task topic (awaiting functional spec from Gershon)
      • References:

        • Troubleshooting Wiki Page

        • Troubleshooting specialization (IBM)

        • http://www.oasis-open.org/apps/org/workgroup/dita-techcomm/email/archives/201011/msg00002.html

   2. ITEM: Discuss change tracking (review management)

      • Reminder: Add use cases to Change Tracking and Control wiki page

   3. ITEM: Release management issues (time permitting)
      • Information sent to SC members with the URL of the webinar recording.
      • Discuss possible impact on the DITA standard.To access the recording of this webinar you will need the following information:

      • http://www.comtech-serv.com/webinar/ReleaseManagement/rel_man.php

      • Username: CIDM
      • Password: 12011relcidm
   4. FUTURE ITEM: Discuss items this SC would like to address. Possible items include:
      • Command Line Interface (CLI) documentation
        • Are the current set of DITA elements adequate? (Cisco is not finding them adequate.) If not, we need to recommend changes to DITA TC.
        • Do we need to document the current set of elements more clearly?
        • Do we need to disseminate best practice information about documenting CLIs using DITA?
        • Who in the community is using DITA to document CLIs, other than IBM and Cisco?
        • Do we need kwdname to compliment varname?
        • Do we need fn in synph?
      • Quick Reference Guides
      • Multimedia solutions
        • Support for multiple image/multimedia objects
        • Are there Tech Comm deliverables that your company needs to produce that might need unique markup or output considerations? How would you describe such deliverables?
      • FAQ (RobH, GershonJ)
6. Open / Announcements
7. Adjourn