OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  Rebranded committee note PDF for you to look at

    Posted 02-01-2019 22:43
      |   view attached
    See attached PDF. Let me know if you see any issues. Obviously, we are still using Arial and Calibri as fonts. I used the DITA source for the "Why three editions of DITA 1.3" committee note, so it can be compared to the 2015 PDF. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 622-1501; kriseberlein (skype) Attachment: dita-why-three-editions.pdf Description: Adobe PDF document

    Attachment(s)

    pdf
    dita-why-three-editions.pdf   372 KB 1 version


  • 2.  Re: Rebranded committee note PDF for you to look at

    Posted 02-04-2019 16:31
    Hi Kris, I noted one small template change which should be applied, and also want to add a note on the URIs. - The PDF page footer should also appear on the first page (It was omitted earlier due to conflict with the long purple sidebar.) - While not actually a template issue, I want to note that we will use "https" instead of "http" in the URIs for all future OASIS publications. (Note this is not retroactive, so the URIs of earlier (pre-https) publications - as in "Previous version" or items in References - should still be cited with "http". This is important particularly for HTML documents which use .css scripts - i.e., most DITA publications. The .css scripts are not activated if older "http" HTML documents are retrieved using "https".) I have not analyzed the fonts, but this all looks good. I'll mention one other item, with no specific conclusion... In Section 2.4, "Future of DITA", (and other similar places) there are two unnumbered subheadings ("Lightweight DITA" and "DITA 2.0") which are not a part of the OASIS style templates. These have been handled in a reasonable way here. In general, we'd prefer to avoid these non-standard elements and simply use the next level of section heading (i.e, 2.4.1 and 2.4.2). While you have handled it fairly well here, it is a source of unnecessary complication in some cases. Best regards, Paul On Fri, Feb 1, 2019 at 5:42 PM Kristen James Eberlein < kris@eberleinconsulting.com > wrote: See attached PDF. Let me know if you see any issues. Obviously, we are still using Arial and Calibri as fonts. I used the DITA source for the "Why three editions of DITA 1.3" committee note, so it can be compared to the 2015 PDF. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 622-1501; kriseberlein (skype) -- Paul Knight ... . Document Process Analyst ... mobile: +1 781-883-1783 OASIS - Advancing open standards for the information society


  • 3.  Re: [dita] Re: Rebranded committee note PDF for you to look at

    Posted 02-04-2019 17:18
    Hi, Paul. Many thanks for checking this over; I appreciate it. Re the unnumbered subheadings -- These represent sections, which are subelements of the DITA topics. We only number topics. We've had this discussion with OASIS Administration and the TAB before -- would you like me to uncover these discussions and forward them to you? The practice of NOT numbering subelements in DITA TC documents is most clearly seen in our spec language reference topics. For example, see http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part3-all-inclusive/langRef/base/navtitle.html#navtitle Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 622-1501; kriseberlein (skype) On 2/4/2019 11:30 AM, Paul Knight wrote: Hi Kris, I noted one small template change which should be applied, and also want to add a note on the URIs. - The PDF page footer should also appear on the first page (It was omitted earlier due to conflict with the long purple sidebar.) - While not actually a template issue, I want to note that we will use https instead of http in the URIs for all future OASIS publications. (Note this is not retroactive, so the URIs of earlier (pre-https) publications - as in Previous version or items in References - should still be cited with http . This is important particularly for HTML documents which use .css scripts - i.e., most DITA publications. The .css scripts are not activated if older http HTML documents are retrieved using https .) I have not analyzed the fonts, but this all looks good. I'll mention one other item, with no specific conclusion... In Section 2.4, Future of DITA , (and other similar places) there are two unnumbered subheadings ( Lightweight DITA and DITA 2.0 ) which are not a part of the OASIS style templates. These have been handled in a reasonable way here. In general, we'd prefer to avoid these non-standard elements and simply use the next level of section heading (i.e, 2.4.1 and 2.4.2). While you have handled it fairly well here, it is a source of unnecessary complication in some cases. Best regards, Paul On Fri, Feb 1, 2019 at 5:42 PM Kristen James Eberlein < kris@eberleinconsulting.com > wrote: See attached PDF. Let me know if you see any issues. Obviously, we are still using Arial and Calibri as fonts. I used the DITA source for the Why three editions of DITA 1.3 committee note, so it can be compared to the 2015 PDF. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 622-1501; kriseberlein (skype) -- Paul Knight ... . Document Process Analyst ... mobile: +1 781-883-1783 OASIS - Advancing open standards for the information society