dita — archive

[Nancy Harrison]

Submitter's message ActionItems: 1. Kris will contact oasis on options for naming updated troubleshooting CN. 2. Eliot will update the RNG open repo text 3. Kris will revise upcoming webinar blurb and send back out ================================================= Minutes of the OASIS DITA TC Tuesday, 14 September 2021 Recorded by Hancy Harrison link to agenda for this meeting: https://wiki.OASIS-open.org/dita/PreviousAgendas Attendance: Robert Anderson, Carsten Brennecke, Kris Eberlein, Carlos Evia, Nancy Harrison, Scott Hudson, Gershon Joseph, Eliot Kimber, Zoe Lawson, Keith Schengili-Roberts, Dawn Stevens, Jim Tivy Business ======== 1. Roll call Regrets: Eric Sirois, Chris Nitchie 2. Approve minutes from previous business meeting: 07 September 2021 2021 https://lists.oasis-open.org/archives/dita/202109/msg00023.html (Harrison, 13 September 2021) moved by Kris, 2nd Scott, approved by TC 3. Announcements Frank Wegmann cannot participate for the next 2-4 weeks; see https://lists.oasis-open.org/archives/dita/202109/msg00031.html 4. Action items [updates only; complete list in agenda] 06 April 2021 Dawn, Gershon, Nancy, Frank, Kris: Work on revised charter COMPLETED 24 August 2021 Robert: Examine DITA 2.0 specs to what can be published (without draft comments if necessary) by part 2 Webinar COMPLETED 31 August 2021: Kris: Request repo for DITA specializations COMPLETED Robert, Kris: Review Eliot's suggested changes to RNG Convertor repo COMPLETED 07 September 2021: Kris: Work with OASIS staff to schedule Webinar for October 2021 - [agenda item #11] Kris: Send updated draft of troubleshooting committee note to TC COMPLETED Carlos, Frank: Test procedure for building PDFs (TC generic, spec, committee note) with OASIS stylesheets - [agenda item #12] 5. Check-in: How are people doing in this difficult time? How is your state/country doing? [no official business] 6. Review of DITA 2.0 proposal deadlines https://wiki.oasis-open.org/dita/DeadlinesDITA2.0 [no updates] 7. DITA 2.0 stage three proposals Vote None Continuing discussion None Initial discussion Updates to diagnostics proposal: https://lists.oasis-open.org/archives/dita/202109/msg00028.html (Eberlein, 13 September 2021) - Dawn; Eliot and Nancy reviewed it, Kris incorporated the edits. was to make the changes we've talked about, both making diagnostics-steps and diagnostics-info not mutually exclusive, and als omaking troubeleshooting solution optional to accout for diagnostics - Kris; so any qand a? any objections to moving to a vote for next week. [none] - Kris; pls everyone look at the latest pdf; changwes marked in brown and glyphs; [vote next week] 8. Straw man charter https://lists.oasis-open.org/archives/dita/202109/msg00018.html (Stevens, 10 September 2021) https://lists.oasis-open.org/archives/dita/202109/msg00019.html (Bissantz, 10 September 2021) https://lists.oasis-open.org/archives/dita/202109/msg00020.html (Chet Ensign, 10 September 2021) https://lists.oasis-open.org/archives/dita/202109/msg00022.html (Joseph, 12 September 2021) Updated straw man, which addresses points raised by Chet Ensign and Gershon Joseph https://lists.oasis-open.org/archives/dita/202109/msg00026.html (Eberlein, 13 September 2021) Query out to Chet: https://lists.oasis-open.org/archives/dita/202109/msg00029.html (Eberlein, 14 September 2021) - Kris; this was worked on by me, Dawn, Nancy, Gershon - Nancy; worked on first part; goal was to make it as gen'l as possible so we wouldn't have to do it again. - Dawn; yes, one thing Chet said was to 'not tie ourselves in knots' so we wouldn;' thave to do it again. Goal was to be a general as possible while stil stating what we were about. - Kris; we struggled on Friday with the 'statement of purpose' section, what DITA is, what's unique, and what it offers. - Kris; any comments? - Gershon; I read the latest version; it works for me. [no more comments] - Kris; I have a query out to Chet; we may need to reorder the exceptions, we also may need to add business benefits, may need to move 'scope of work' to before 'deliverables', and add 'business benefits' as well. If folks are generally OK with this, we'll finish it up based on feedback on what's required and what the order has to be. So please comment now if you have concerns. Also take a look at the original charter to compare it with proposed new one. 9. Using DITA 2.0 Troubleshooting committee note https://lists.oasis-open.org/archives/dita/202108/msg00034.html (Eberlein, 31 August 2021) Most recent draft PDF: https://lists.oasis-open.org/archives/dita/202109/msg00024.html (Eberlein, 13 September 2021) Title for committee note https://lists.oasis-open.org/archives/dita/202109/msg00015.html (Eberlein, 07 September 2021) https://lists.oasis-open.org/archives/dita/202109/msg00016.html (Hudson, 07 September 2021) https://lists.oasis-open.org/archives/dita/202109/msg00017.html (Harrison, 07 September 2021) - Kris; one question we have is the best title. it's a bit confusing. - Nancy; if we're not going to do it again, I'd go with #3, if not, then #2. - Gershon; I think we sohould go with third option - Scott; I agree that we sho0uld focus on 2.0. - Gershon; if OASIS insists, then use option 2. - Dawn; hate to disagree, but I automatically make the version apply to the document rather than the release. - Scott; but that is the 2nd version, Bob's was the first. - Kris; not really, it wasn't done as a CN but a a white paper - Carlos, I think we need to make it clear which this is. - Kris; whatever we do, we should decide and it will be what we do for all future CNs. if we were to update this, we might neede to retain the same version number. - Nancy; if that's the case, it definitely shouldn't be in the title, - Scott; I agree, - Kris; I'll send a note to OASIS to clarify. ***ActionItem: Kris will contact OASIS on options for naming updated troubleshooting CN. 10. DITA TC Open OASIS repos a. Continuing New repo for specializations not part of the standard Requested by Eberlein on 07 September 2021 Opened on 10 September 2021: https://lists.oasis-open.org/archives/dita/202109/msg00021.html (Chet Ensign, 10 September 2021) - Kris; Chet has opened the repo, we need to get the source for our specializations into the repository; that will take some forethought and some setup work. Robert, will you be able to do that? - Robert; will take some thought ... With 1.3, you need the full set of grammars to make these work, so we need to start by committing the 1.3 errata 2 hot fix, which will just be everything. For 2.0, we need to create separate modules with pointers to working versions of 2.0, or it will break every time we update DITA. - Kris; once we have these set up so they work with 2.0, we can put a tag on them so folks won't have to clone the entire repository, they can just download a zip. But for dev work that will take place in the repo, we'll need submodules for base. - Robert; and those do conflict, but we can have plugins and submodules and we should have both. - Kris; Robert, for first commit, should we upload all the grammar file, minus XSDs, for 1.3? - Carlos, will L&T be independent of grammar file? - Robert; for L&T 1.3, you need everything for them to work, and anyone using L&T 1.3 is using the whole folder, so it makes no sense to split them out. - Kris; we'll put in a master branch, and then a dev branch, and the dev branch is where the work will go for reconfiguring work. - Robert; in main repo, we'll have a main and dev branch. - Nancy; for the 2.0 compatible L&T files, are we going to get rid of all but the div2 stuff? - Kris; yes. [discussion among Kris, Carllos, Eliot around the details on github work, master and mail branches and submodules] - Kris; remember, we can get non-OASIS folks to work on this, they can work in a an open OASIS repo; maybe we can get someone out of the TC to help. b. Continuing RNG converter https://lists.oasis-open.org/archives/dita/202107/msg00008.html (Eberlein, 13 July 2021) https://lists.oasis-open.org/archives/dita/202107/msg00009.html (Chet Ensign, 13 July 2021) Need to revise statement of purpose to cover generating monolithic XSD (DTD also?) https://lists.oasis-open.org/archives/dita/202108/msg00036.html (Kimber, 31 August 2021) https://lists.oasis-open.org/archives/dita/202109/msg00007.html (Eberlein, 07 September 2021) - Kris; Eliot, can you fix the rng stuff by next week? - Eliot; yes I can, though i won't be able to work on it before Friday. ***ActionItem: Eliot will update the RNG open repo text 11. Rescheduled Webinar Blurb for Webinar https://lists.oasis-open.org/archives/dita/202109/msg00034.html (Eberlein, 14 September 2021) - Kris; first wold like to feedback on my draft blurb for the webinar - Zoe; wrt questions, make it clear you could send your questions now, ask people to cme with questions - Kris; don't want people do don't have questions to not com - Gershon; move paragraph 4 up to be para 2. - Kris; so that;, and make it specific to please develop questions ahead of time and let us know about them. i'll revamp this based on this discussion and send it back out. ***ActionItem: Kris will revise upcoming webinar blurb and send back out Things we need DONE in advance of 05 October 2021 DITA specializations repo populated with DITA 1.3, Errata 02 source Revisions to RNG converter completed Diagnostics proposal approved and integrated Misc fixes integrated into grammar files (documentation can come later) Grammar files and draft specs available as downloads - Kris; Robert where does misc fixes stand? - Robert; all approved ones have gone into grammar files - Zoe; will come a review process where outside people look at spec. do we make changes based on the review. - Kris; yes we do. if someone suggests a substantive change, we might, though that would push us back tot he beginning. We;ve never done that, - Zoe; didn't realize it reset things. - Krisl we'vve nver done that; generally, changes ha ve been non-substantive. if we were to make a change that would make grammar files non-compatible withprevious versions of 2.0, that would require a reseet. - Robert; in past ahve never had to make that kind of change, - Kris; we hope to have as many peoel review it as we can get, inside and outside of oasis 12. Setting up an OASIS publishing environment https://lists.oasis-open.org/archives/dita/202109/msg00013.html (Eberlein, 07 September 2021) Feedback from Carlos and Frank? - Kris; i kind of documented this with stylesheets for spec, CN, and non formal things. Carlos & Frank offered feedback - Carlos; i just got a message that notes a considerable number of erros, there are a number of spaghetti refs and ino arch of LwD main map. - Robert; would also notes that FOP is unkind when links are missing their targets, FOP just crashes instead of issuing a warning. - Kris; so this is about problems in the documetn, but did you have the opportunity build a CN or a generic - Carlos; i only tried to build my stuff, since i needed to build it. - Robert; and my build of LwD crashed in the same way Carloss; did, so - Kris; sent a revised version to Carlos about opening an oxygen Oxygen project files. how many people here use them? [none] - Zoe; when i'm able to use oxygen, connected to some other source control tool. , so i haven't used them. - Kris; i use them to keep from altering the builtin oxygen environment. and I use them so I don't have to re enter my preferences all the xformation parameters for these xforms. - Zoe; think it's a feature that if you understand them, it's powerful, but not if you haven't used them. - Zoe; i try to build ona build server. - Kris; i probably have 20-30 different versions of DITA-OT, so I need to switch easily. Kris; I encourage anyone else to set up our env . 12 noon ET close -- Ms. Nancy Harrison Document Name : DITA TC Meeting Minutes 14 September 2021 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 : 2021-09-25 09:40:11