------------------------------------------------------- OASIS DITA Technical Committee Minutes Tuesday, 16 June 2009 ------------------------------------------------------- Minutes recorded by Seth Park. 1. ROLL CALL - Quorum met see the meeting page for detailed attendance information: http://www.oasis-open.org/apps/org/workgroup/dita/event.php?event_id=22259 ---------------------------------------------------------------------------------------- 2. APPROVE MINUTES FROM PREVIOUS BUSINESS MEETINGS: see http://lists.oasis-open.org/archives/dita/200906/msg00032.html (9 June 2009) Motion made by Don Day to approve the meeting minutes as posted; seconded by Bruce Nevin ---------------------------------------------------------------------------------------- 3. SUBCOMMITTEE REPORT: OASIS DITA ADOPTION TC Gershon Joseph provides updates regarding A) Articles written by Adoption TC members: * DITA 1.2 Feature article entitled, "Keyref Overview -- DITA 1.2" by Sowmya Kannan; posted to http://dita.xml.org/resource/keyref-overview-dita-12; It will be announced broadly in the coming days/weeks. * Considerations when choosing DITA tools, including CMS, editors, and publishing environments * "Spot analysis" outlining pros and cons about moving to DITA. This is actually a set of articles and presentations to help potential users get support for DITA in their organizations. There are three primary focus areas: - Business focus - Author focus - IT focus * Work in progress articles: "Task modeling" and "DITA 1.2 Linking Improvements". Several other articles have been suggested but not yet assigned to writers. If you're interested in writing for the Adoption TC, please contact Gershon B) TC members are developing a test suite of content that will be useful in evaluating DITA tools C) Updates w.r.t. the DITA Adoption Focus Area, which is a subcommittee of the DITA Adoption TC. - The most active member for maintaining the dita.xml.org site has left the SC. Gershon issued a call for help. Anyone interested in assisting with this activity should contact Gershon Joseph or Kristen Eberlein. ---------------------------------------------------------------------------------------- 4. ITEM: REVIEW MASTER TOPIC LIST--GERSHON (JUNE 15 CLOSE FOR INPUT THIS ITERATION) A) AUTHORING TEAM SPECIAL MEETING MINUTES (see http://lists.oasis-open.org/archives/dita/200906/msg00095.html) * On target to release the first draft today. * Kristen Eberlein will release CHM and TOCJS review versions late this evening; absolute deadline for content is 10pm EST. * Gershon indicated that there has been a lot of activity and recognized the outstanding efforts of the author group. B) UPDATES ON JOANN HACKOS' KEY DITA CONCEPTS These concepts are to be discussed up-front, though they may still be further explained in other, relevant areas of the spec. Gershon will follow-up with JoAnn regarding these concepts. Some specific discussion included: * "inheritance" -- Group was not clear on what the intent of this concept is. Nancy Harrison wrote about attribute inheritance as it applied to her publishing topics. * Nancy also included transclusion information in her topics, which generated discussion about the proper place for keyref and href. Michael Priestly was concerned that keyref could be buried in an inclusion topic, though keyref can have broader applications. Su-Laine Yeo suggested a heading entitled, "Content assembly and linking" that would provide appropriate navigation to keyref and href information. The suggestion was accepted by the participants. * "Internal link" -- it was suggested that this concept could be covered in "link processing." C) UPDATES ON "INTRODUCTION TO DITA" TOPICS * Gershon requested help from the TC for these topics before they were marked "ready for review." The call for help was answered by Eliot Kimber and Don Day; Gershon Joseph offered to serve in an editorial role. ---------------------------------------------------------------------------------------- 5. ITEM: SPREADSHEET LOCATED IN SUBVERSION REPOSITORY see http://wiki.oasis-open.org/dita/DITA_1.2_specifications%3A_Authoring_and_editorial_guidelines Gershon discussed recent updates and outstanding activities. Many of the topics that were not flagged as "ready for review" were actually ready. Gershon requested that authors spend their time focusing on the development of topics and not worry about the spreadsheet being out-of-date. After the topics are committed to SVN, please update the spreadsheet accordingly. ---------------------------------------------------------------------------------------- 6. REVIEW PROCEDURE Reminder for authors/reviewers: http://lists.oasis-open.org/archives/dita/200906/msg00011.html Kristen Eberlein and Gershon Joseph reminded the author group of the review procedure. * For simple typo/grammar issues, it is acceptable to communicate the change by editing an html page (with clear formatting to indicate the modified regions) or using a Microsoft Word / Open Office Document with "track changes" feature. * For issues that require substantive rework or discussion, capture the issue in the wiki. Guidelines for the wiki: - From the top-level author guidelines page (http://wiki.oasis-open.org/dita/DITA_1.2_specifications:_Authoring_and_editorial_guidelines), find the section called "Review #1: 16-30 June 2009". There, you will see a link to the wiki page for the first review. Each major section has a wiki page linked from the review wiki. To indicate an issue, create a heading with a title equal to the topic title of the topic that contains the issue. Describe the issue under the heading. Don Day requested that a clear disclaimer be added to each of these wiki pages. He is concerned that someone may find these pages via a web search and assume that the information is authoritative. Kristen Eberlein agreed to add these disclaimers. ---------------------------------------------------------------------------------------- 7. ITEM: MEANINGFUL VALUES FOR TYPE= ON XREF AND TOPICREF see http://lists.oasis-open.org/archives/dita/200905/msg00033.html Item remains open ---------------------------------------------------------------------------------------- 8. ITEM: REFERENCING A BOOKMAP FROM A MAP (RESUMED THREAD) see http://lists.oasis-open.org/archives/dita/200906/msg00020.html (Grosso) It was determined that a resolution could not be made on the call. Michael Priestly suggested a special call, which will take place on Tuesday, June 23 immediately following the TC call. If you are interested in joining this discussion, plan to stay on the call after the official call adjourns. The TC intends to revisit this item on the June 30 call. ---------------------------------------------------------------------------------------- 9. ITEM: NEED CLARIFICATION OF THE MEANING OF SCOPE="PEER" see http://lists.oasis-open.org/archives/dita/200906/msg00048.html (Kimber) Eliot Kimber explained that the architectural specification should explain what is intended when a map references a map with a scope="peer". This has publication implications, especially for keyref resolution. (Note from minutes taker: my notes were sketchy here, so I contacted Robert Anderson after the call to fill in the gaps. The following is from that exchange, not transcribed from the official call.) Robert Anderson clarified: "We recently clarified that scope="peer" on a map reference means that the map itself is a peer, and thus a separate inaccessible item (similar for scope="external"). For reference -- here are the minutes where we discussed and voted on that behavior, item #4: http://lists.oasis-open.org/archives/dita/200905/msg00030.html" ---------------------------------------------------------------------------------------- 10. NEW ITEM: CLI BRIDGED SW AND PR DOMAINS see http://lists.oasis-open.org/archives/dita/200906/msg00086.html (Nevin) Bruce Nevin described the desire to reuse semantics from the syntax diagram structure and some of the obstacles of doing so. The call ran out of time before giving adequate discussion, so this item remains open and will be discussed at the next TC call. ---------------------------------------------------------------------------------------- ADJOURN Don Day called the meeting to a close. ---------------------------------------------------------------------------------------- ACTIONS 1) Authors continue working toward 10PM EST draft 1 cut-off 2) Contact Gershon or Kristen if you want to help with the DITA Focus Area SC (by authoring or helping with the website) 3) Gershon to clarify intent of some "key DITA concepts" (see comments on wiki) 4) Kristen to add draft disclaimers to review wiki pages 5) Plan to attend the June 23 post-TC-call if you are interested in the "map references bookmap" issue 6) Don to add the "map references bookmap" item to the June 30 agenda 7) Kristen to add the clarification of scope="peer" when a map references a map 8) Don to add the "CLI bridged SW and PR domains" item to the June 23 agenda