OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-techcomm message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Modified: DITA Technical Communications Subcommittee Meeting


Submitter's message
The updated minutes and the agenda for the April 3, 2017 meeting have been added to this event.
-- Mr. Robert Thomas
Event Title: DITA Technical Communications Subcommittee Meeting

Date: Monday, 03 April 2017, 09:00am to 10:00am MDT
Location: WebEx - Inquire to the list for connection information
Description

Regular business meeting


This meeting counts towards voter eligibility.

Agenda

The following topics are up for discussion:

  1. Agenda for 4/3/17

    1. Approve minutes

    2. Action items   
    Troubleshooting diagnostic feature proposal - Bob
    Programming inline element expansion - Scott

    3. Separation of technical content from the core DITA specification.

    Discuss revised feature proposal

    4. Bookmap and publication map discussion

    5. Glossary

    6. Additional items


Minutes

OASIS DITA Technical Subcommittee meeting minutes 
Friday, March 20, 2017
Recorded by Jane Credland
 
Attendees:

 
Bob Thomas
Don Day
Joe Storbeck
Robert Anderson
Scott Hudson
Jane Credland
  
1. Approve minutes from December 12, 2016 and January 27, 2017 
Moved by Bob, seconded by Joe. Approved without corrections.
 
——————
 
2. Diagnostic element stage 1 proposal 
Bob doesn’t have the draft ready for this meeting. 
AI – Bob – done by the next meeting in two weeks.
 
——————
 
3. Update on programming inline discussion 
Scott was not able to get the proposal completed.
 
Nothing new came up at the Portland listening session, just confirmation of what was needed for the web services, but not any request for any particular element.
 
AI – Scott – proposal for next meeting in two weeks
 
——————
 
4. Separation of technical content from DITA 2.0 core
 
No plans to migrate the schema/technicalContent
 
Robert Anderson agrees with this. We can move away from the requirement for modular DTDs and XSLTs as part of the spec. Modularity will be part of the RNG.
 
Bob: Striking that paragraph from the draft.
 
Robert: Not sure that this is what he expected, just based on what he saw in the agenda. This seems to combine a lot of features into one. The separation of technical content into its own thing outside of the base. I think it’s going to be a lot more complicated than it sounds. It’s something that has to be considered on its own and it’s a big thing, and we need to work through implications, side effects and delivery issues.
 
Also covers the creation of a new information type, a new domain.
 
Bob: The information type is simply an example (a use case); it’s a hypothetical - it would be easier if it were like this. Needs to make that clearer.
 
Bob: not too many dependencies on the base spec.
 
Robert: something this doesn’t address - when shipping technical content as it’s own thing, do we also include the base as it’s own required work product, some part of it, or nothing (and we don’t include the cross-linking). They all have a different impact on usability.
 
Bob: is it our intention to quit shipping content models with the spec.
 
Robert: I’m hoping so.
 
Bob: need to solve the problem of attribute definition.
 
Robert: the linking tends to spider-web out from that. Topics about keys and conrefs. By the time you go through those attribute, most of those really complex attributes have a whole section in the architectural spec about them.
 
Bob: by the time you resolve the dependency chains, you have a base spec.
 
Robert: Do we bundle those things? Link to a published base spec? Easier if the base comes out first. Doesn’t have a good answer for this. Comes down to which answer we pick and what are the consequences.
 
Bob: one of the things I need to do is to talk about what those choices are.
 
Robert: do we want to come out of this group with a recommendation? Something that the TC as a whole will have strong opinions about.
 
Bob: we can recommend something but…
 
Robert: might be good to list those issues and get feedback from the TC.
 
Bob: best tack is to the list the possibilities and ask the TC for guidance. No requirement that you go to the TC with a complete, ready to approve, proposal
 
Jane: question about backwards compatibility.
 
Robert: separating out as a package shouldn’t have any impact on its own. Almost what we have today except that we approve three packages at once, rather than independently.
 
Bob: we may do things to the spec that impact backwards compatibility, but this won’t. Owe it to our users to have a very solid reason fro doing it.
 
AI – None taken
 
——————
5. Bookmap and DITA inadequacies (TC discussion)
 
Bob: there is a need for some kind of publication style construct, beyond what is available in out of the box maps. Also discussed missing bookmap definiciences. Missing some metadata functionality. Some discussion about he content model being overly restrictive. Where do you put things like key definitions (resource only links to keydefs)? Where do you put information about your cover page (info on the cover beyond what’s in the metadata, graphic, etc).
 
In 2.0 timeframe, probably need a more generic publication construct. Might be things that can be done to maps to make them more useful, reducing compatibility problems.
 
Scott: one of the things that maybe we can borrow from DocBook - they have a cover element, where you can specify a cover image and other specific items that might be a useful way to get around the lack of a specific element for that in the book structure.
 
Bob: is there an interest in the SC to take a look at bookmap to see what we can do to improve it.
 
Scott: I’m definitely interested in that.
 
Don: I’ve been pondering just how high up the design ladder one might need to climb; there’s a higher echelon of job control that includes not only the content decision in ditaval files but also the cover and other items we’ve put into the book metadata but which might be better controlled at the
 
Don’t want to propose it at the moment; not just book production but job control issues. May include things like digital asset management.
 
Bob: one of the things I would like to see is a bookmap or something that succeeds it in the core specification.
 
Robert: set out a group mind map space somewhere
 
Jane; need to provide a way to make it not user-editable always.
 
Bob: that’s an implementation issue, in the DITA-OT for example
 
Robert: thinks Bob is right. The TC is to provide mark-up. What can be edited or not edited is part of implementation; IA can provide specializations o remove that element. IBM is already doing that. Alternatively, we can  - schematron in Oxygen - add a rule in your editor to flag it; can do the sam thing in your transforms TC can’t provide an element and then say here’s a way to remove it
 
Bob: Before we can go much further, it would be good to see what the TC wants to do about creating a new specialization.
 
Robert: it hasn’t progressed to the point where anyone has taken ownership of it but the discussion seems to generally be in favor of it.
 
Bob: either way, we probably need to be doing something with bookmap in 2.0. My guess is that we’re not going to eliminate or even deprecate bookmap in 2.0.
 
Scott: I think it will be additions, if anything.
 
Bob: wants to try and do this without introducing a lot of additional complexities to the bookmap structure - we have some opportunities to make it easier to use without making it more complicated.
 
Scott: if we can address some of the common needs, not trying to over-ride something to get support for certain things; it will be a lot more helpful for folks
 
Bob: if we take this on, I’d like to get feedback from the DITA-OT project on what they’d like to do
 
AI – None taken
 
——————
 
6. Additional items
 
Scott: Glossary is a major painpoint for most people.
 
Bob: on the agenda for next time. I would like to see where the TC is going with glossary before we invest a lot of energy into it
 
Scott: volunteered to try to put together a proposal for the TC. He’d be fine with including it here to get some early feedback

 



Owner: Mr. Robert Thomas
Group: DITA Technical Communication SC
Sharing: This event is shared with the OASIS Open (General Membership), General Public, and OASIS Darwin Information Typing Architecture (DITA) TC groups. Public Event Link
  • Learn more about subscribing here.
  • View the DITA Technical Communication SC calendar here.
  • You may receive future notifications with updates to this event. Update the event on your calendar by accepting the changes.

Attachment: ical_44320.ics
Description: application/ics

BEGIN:VCALENDAR
CALSCALE:GREGORIAN
METHOD:REQUEST
VERSION:2.0
PRODID:-//Kavi Corporation//NONSGML Kavi Groups//EN
X-MS-OLK-FORCEINSPECTOROPEN:TRUE
BEGIN:VTIMEZONE
TZID:America/Denver
BEGIN:STANDARD
DTSTART:20001029T020000
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10;UNTIL=20061029T080000Z
TZNAME:MST
TZOFFSETFROM:-0600
TZOFFSETTO:-0700
END:STANDARD
BEGIN:STANDARD
DTSTART:20071104T020000
RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=11
TZNAME:MST
TZOFFSETFROM:-0600
TZOFFSETTO:-0700
END:STANDARD
BEGIN:DAYLIGHT
DTSTART:20000402T020000
RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=4;UNTIL=20060402T090000Z
TZNAME:MDT
TZOFFSETFROM:-0700
TZOFFSETTO:-0600
END:DAYLIGHT
BEGIN:DAYLIGHT
DTSTART:20070311T020000
RRULE:FREQ=YEARLY;BYDAY=2SU;BYMONTH=3
TZNAME:MDT
TZOFFSETFROM:-0700
TZOFFSETTO:-0600
END:DAYLIGHT
END:VTIMEZONE
BEGIN:VEVENT
STATUS:CONFIRMED
TRANSP:OPAQUE
DTSTAMP:20170402T213906Z
DTSTART;VALUE=DATE-TIME;TZID=America/Denver:20170403T090000
DTEND;VALUE=DATE-TIME;TZID=America/Denver:20170403T100000
SEQUENCE:5
SUMMARY:DITA Technical Communications Subcommittee Meeting
LOCATION:WebEx - Inquire to the list for connection information
LAST-MODIFIED:20170402T213906Z
ORGANIZER:workgroup_mailer@lists.oasis-open.org
ATTENDEE;CUTYPE=GROUP:MAILTO:dita-techcomm@lists.oasis-open.org
DESCRIPTION:Regular business meeting\n\nAgenda: The following topics are
  up for discussion:\n\n\n	\n	Agenda for 4/3/17\n\n	1. Approv
 e minutes\n\n	2. Action items   \n	Troubleshooting diagnosti
 c feature proposal - Bob\n	Programming inline element expans
 ion - Scott\n\n	3. Separation of technical content from the 
 core DITA specification.\n\n	Discuss revised feature proposa
 l\n\n	4. Bookmap and publication map discussion\n\n	5. Gloss
 ary\n\n	6. Additional items\n	\n\nGroup: DITA Technical Comm
 unication SC\nCreator: Mr. Robert Thomas
URL:https://www.oasis-open.org/apps/org/workgroup/dita-techcomm/event.php?event_id=44320
UID:https://www.oasis-open.org/apps/org/workgroup/dita-techcomm/event.php?event_id=44320
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:REMINDER
TRIGGER;RELATED=START:-PT00H15M00S
END:VALARM
END:VEVENT
END:VCALENDAR


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]