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


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

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

Subject: Groups - DITA TC Meeting Minutes 20 June 2017 uploaded

Submitter's message
1. all TC members who haven't yet done so will send comments, or a note that they have no add'l comments to add to the ones already received, to TC by next week's meeting
2. Bob will upload latest SC governance document changes to SVN and check them in
3. Kris will reply on dita-comment list to Stefan Eike's question about translating '@processing-role="resource-only"' content
Bob; include-domains should have 'topic' in front of hi-d.
Robert; yes, it should match what we're using in full DITA.
4. LwD SC should make following change in grammer files and any doc; include-domains for highlighting domain hould have 'topic' in front of hi-d
5. LwD SC will have grammar files prefixed with lw-
6. Kris will send a request to OASIS for a template for the CN to introduce a multimedia domain in DITA 1.3

Minutes of the OASIS DITA TC
Tuesday, 20 June 2017
Recorded by Nancy Harrison
link to agenda for this meeting:

1. Roll call
Regrets: Dick Hamilton, Stan Doherty

2. Approve minutes from business meeting on 30 May 2017:
https://lists.oasis-open.org/archives/dita/201706/msg00058.html (Tom Magliery, posted 13 June 2017)
moved by Kris, 2nded by Alan, approved by TC

3. Announcements:
New TC members: None

4. Action items
6 September 2016
- Kris: Revise subject scheme example topic pulled from errata 01
4 October 2016:
- Tom: Work on aggregated minutes for 2005-2011 (IN PROGRESS)
04 April 2017
- All TC members consider what they want to see on the new DITA.xml.org site for the DITA TC
06 June 2017:
- All voting members: Review Lightweight DITA package (See TC review of LwDITA, take 1)
13 June 2017:
- LwDITA subcommittee:
o Correct all the issues mentioned in https://lists.oasis-open.org/archives/dita/201706/msg00027.html (Anderson, 9 June 2017)(COMPLETED)
o Add image, alt, and xref to the content model for ph in map (COMPLETED)
o Make id attribute optional on map (COMPLETED)
o Add domain constraint token to map (COMPLETED)
o Make localization attributes available on all elements mentioned in https://lists.oasis-open.org/archives/dita/201706/msg00030.html (COMPLETED)
o Add format and scope attributes to keydef, image, and data (COMPLETED)
o Remove filtering attributes from dt and dd (COMPLETED)
o Add outputclass to all elements that have it in DITA 1.3 (COMPLETED)
o Make props available on keydef (COMPLETED)
o Consider content model for dd element -- Should it contain dl? simpletable?
***ActionItem; all TC members who haven't yet done so will send comments, or a note that they have no add'l comments to add to the ones already received, to TC by next week's meeting

5. Subcommittee governance
Current document: https://lists.oasis-open.org/archives/dita/201705/msg00051.html
https://lists.oasis-open.org/archives/dita/201705/msg00055.html (Chet Ensign, 24 May 2017)
https://lists.oasis-open.org/archives/dita/201705/msg00056.html (Eberlein, 24 May 2017)
https://lists.oasis-open.org/archives/dita/201705/msg00057.html (Chet Ensign, 24 May 2017)
https://lists.oasis-open.org/archives/dita/201705/msg00076.html (Chet Ensign, 25 May 2017)
Suggested update: https://lists.oasis-open.org/archives/dita/201706/msg00046.html (Thomas, 12 June 2017)
Bob; gave overview of current proposal (last mail, above), which he made in response to Chet's comments on original draft.
Kris moved to approve this as submitted by Bob, 2nded by Maria, approved by TC
***ActionItem: Bob will upload latest SC governance document changes to SVN and check them in

6. E-mails to dita-comment list: https://lists.oasis-open.org/archives/dita-comment/
https://lists.oasis-open.org/archives/dita-comment/201706/msg00000.html (Stefan Eike, 1 June 2017)
https://lists.oasis-open.org/archives/dita/201706/msg00065.html (Thomas, 17 June 2017)
https://lists.oasis-open.org/archives/dita/201706/msg00066.html (Kimber, 17 June 2017)
Kris went over Stefan Eike's mail, which she'd forwarded to list; there had been corrections by Bob and Eliot. Resolution is that Stefan is correct, translation vendor was incorrect. It appears that the vendor's info source used to be a member of the translation SC, but that SC was no longer active by the time @processing-role was developed. In any case, Kris will reply on dita-comment list.
- Tom; checking the spec definition/description of @processing-role, it notes that topics marked with this @ are not to be rendered as topics (only conref'd) or in the TOC, but it doesn't exempt that content from translation.
- Robert; it doesn't imply any default for @translate.
***ActionItem; Kris will reply on dita-comment list

7. Lightweight DITA proposal
- Committee note draft: https://www.oasis-open.org/committees/download.php/60914/LwDITA-v1.0-cn01-wd17.pdf
- DTDs: https://www.oasis-open.org/committees/download.php/60915/org.oasis.xdita.zip
- Overview of work for the TC: https://lists.oasis-open.org/archives/dita/201706/msg00015.html (Eberlein, 6 June 2017)
- Browsable content models: https://td-demo.titaniasoftware.com/portals/ui/lwdita-dtd/ (Courtesy of Chris Nitchie)
- Review comments: DTDs
o Need for header comments (ALREADY ADDRESSED)
https://lists.oasis-open.org/archives/dita/201706/msg00041.html (Eberlein, 10 June 2017)
o Error in entity
https://lists.oasis-open.org/archives/dita/201706/msg00040.html (Thomas, 10 June 2017)
- Bob; include-domains should have 'topic' in front of hi-d.
- Robert; yes, it should match what we're using in full DITA.
***ActionItem; LwD SC should make that change in grammer files and any doc; the TC may revisit this when we disuss in detail how LwD should be handling domains
o File names
https://lists.oasis-open.org/archives/dita/201706/msg00042.html (Eberlein, 10 June 2017)
- Kris; we should have a prefix for the files, so they aren't exactly the same file names as 'real' DITA.
- Robert; I also think it's a good idea.
- Tom; what about 'lw-'
- Carlos, we're using 'xd' what about that?
- Kris; I have another piece of email suggesting 'lw-' rather than 'xd-'.
- Robert; I also prefer 'lw' rather than 'xd'
- Kris; the minute we're actually in a DTD/XSD/RNG file, we're well within real XML, so we don't have to highlight the fact that it's XDITA.
***ActionItem: LwD SC will have files prefixed with lw-
o General questions
https://lists.oasis-open.org/archives/dita/201706/msg00043.html (Eberlein, 11 June 2017)
- Kris; 'add filtering @' section. what is intent for filter-add entity?
- Carlos and Mark explained that they weren't clear about the intent; it seemed to be from the time when they were just trying to match DITA doc shells.
***ActionItem: LwD SC will explain intent of or remove that entity
- Robert; at a more general level, entities can be handy, but we shouldn't require them for LwD; it gets away from the 'lightweight' model. And in the final product, we don't want anything lying around to clutter it up, as in DITA 1.0.
- Mark, looking at it, it looks extraneous
- Kris; wrt the 2nd item in that mail; do we need explanations of this kind of thing for the LwD spec?
- Carlos; I think that can disappear, in context of Robert's comments
- Alan; I'd agree
- Kris; was SC planning not to have configuration of those elements?
- Mark; not a lot of config to be done.
- Alan; and if people do provide config, would they provide their own shells and know what they're doing?
- Mark; yes.
- Chris; for a long time, SC was working from the assumption that there would be template-based specialization; this issue is probably a relic of that. And we shouldn't do template-based specialization, but we do need to document how to specialize in LwD.
- Kris; and we need to also document configuration. so what ActionItem do we want to give the SC. just to this item, or more general look?
- Robert; we need to take a fuller look at design as we go along. some gen'l issues with overall design, e.g. where elements are ref'd as entities vs element names, some of this falls into 'making it tidy' but now it's not hurting anything.
- Kris; the major big-picture design issues are LwD and specialization, and LwD and configuration. We can tag this as housekeeping and go back to it later.
- Nancy; how will we keep it on our radar?
- Kris; i'll keep it on the agenda marked as 'incomplete'
- Review comments: Chris Nitchie
https://lists.oasis-open.org/archives/dita/201706/msg00033.html (Nitchie, 9 June 2017)
Chris's e-mail covers several topics:
o Multimedia domain -- Should it be removed from LwDITA or should the DITA issue a standalone domain?
- Chris; the presence of this domain in LwD, but not in 1.3, really makes LwD incomnpatible with 1.3, unless you've added that domain to your shells. In absence of its existence, it's a real problem. The only way to solve it is for TC to release an official multimedia domain as a work product.
- Kris; I'm in agreement, I argued around it by saying it could be constructed, but with the way @iframe is used to define things, you couldn't really do that.
- Eliot; I'm wondering what we mean by 'compatible with' do we mean all elements are also included, or a conforming specialization?
- Robert; people will assume it's a subset, not a conforming specialization. To be compatible, it would have to be done with every configuration.
- Chris; and wrt @iframe, I recommend it get redesigned as something we (DITA TC) could integrate better.
- Kris; so there are a number of possibilities;
1. remove multimedia
2. redesign multimedia so it doesn't require @iframe and convey thatd ata a different way.
- Kris; TC could release a multimedia specialization.
- Carlos; I'd support that, and would be glad to work with anyone on that. @iframe came from a discussion with Oxygen. but we can redesign it without @iframe.
- Kris; are we releasing 1.4, or a CN of 'this is an early preview?
- Robert; don't think we'll do a 1.4 release; I think a CN is a great way to go. it still will be a point of confusion; but we can have a 1.3-comp[atible CN with the multimedia domain
- Nancy; it will only berelevant to compatibility with LwD, so it won't confuse regular DITA users.
- Chris; a good beta test for doc'ing separate modular pieces, as will be case
- Kris; shall we give AI to LwD to redesign multimedia domain so it only uses @s available in 1.3, and in addition, write and release a CN introducing a multimedia domain for DITA 1.3 (Carlos, Chris, Eliot, and Keith volunteered)
[consensus from TC to release a CN introducing mediaobject domain]
- Kris; we need a working title "Multimedia domain for DITA 1.3'
***ActionItem; Kris will request a template for a CN for this CN.
[continuing Chris's items]
- Chris; I also have some discomfort about the fact that multimedia elements are specialized from object, but object isn't in LwD.
- Mark; it's only neeeded if you're going to change the DTD.
- Kris; in any specialization, you can exclude the element the domain is specialized from.
- Chris; it just seemed odd to me...
- Robert; yes but this can be done, for someone familiar to full DITA, it seems weird, but for someone new, it seems normal and less complex that the alternative.
- Chris; LwD is about limiting things, that's the point.
- Mark, if you really need more flexibility, you go to full DITA.
- Kris; the absence of 'object' should be something we talk about when we explain LwD,
- Carlos; and for people who want to further specialize LwD, they'll need it.
- Chris; I'm comfortable with that

o Validation of HDITA and MDITA
- Chris; There's a lack of understanding of how to validate these for processing
- Mark; a terrifying area; there is no standard for Markdown; we're basing on CommonMark, but there's no validation tools for
- Chris; but something can be valid HTML or Markdown without being valid HDITA or MDITA or Markdown; we always thought 'the toolchain will handle it', but that's not really sufficient.
- Robert; the problem is that here we're getting a response from a tool vendor asking 'how do I validate it?'
- Mark; Microsoft is currently working out how to validate their own particual flavor of Markdown.
- Robert; the difference between having to validate Markdown, and having some guidance about how to handle something that's not valid.
- Chris; even if it just said 'vendors can do what they want with invalid.
- Mark; we need to get MP back on the SC to discuss this.
- Kris; is best thing referring this back to SC, or a meeting between SC and processor experts?
- Carlos; we should start with SC, get MP's
- Kris; but MP doesn't have expertise in this area, so might be better to talk with processor people?
- Mark; we have Jang, might be good to takl to him
- Kris; but he's not a developer
- Carlos; then
- Kris; I'll reach out to Carlos and Chris and others to try and move forward on this;
[continued to next week; remainder of Chris's not-yet-address LwD review comments/emails left below for context]

o Values for the custom data attributes
o Presence of object specializations without object
o xref element and type attribute
https://lists.oasis-open.org/archives/dita/201706/msg00045.html (Anderson, 12 June 2017)
https://lists.oasis-open.org/archives/dita/201706/msg00051.html (Kimber, 13 June 2017)
o Corrections to committee note draft

12 noon ET close

-- Ms. Nancy Harrison
Document Name: DITA TC Meeting Minutes 20 June 2017

No description provided.
Download Latest Revision
Public Download Link

Submitter: Ms. Nancy Harrison
Group: OASIS Darwin Information Typing Architecture (DITA) TC
Folder: Meeting Notes
Date submitted: 2017-06-21 02:51:18

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