OASIS Darwin Information Typing Architecture (DITA) TC

Why the shift from -//OASIS//DTD LW DITA Topic//EN to -//OASIS//DTD XDITA Topic//EN ? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer -//OASIS//DTD LIGHTWEIGHT DITA Topic//EN . The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype)

The public identifier changed to XDITA because readers were understanding LwDITA as XML only.  He subcommittee has a more robust set of sample files in the GitHub repository and I plan to improve them as the TC and public review this draft of the note.  Carlos  On Sat, Jun 10, 2017 at 7:55 AM Kristen James Eberlein < kris@eberleinconsulting.com > wrote: Why the shift from "-//OASIS//DTD LW DITA Topic//EN" to "-//OASIS//DTD XDITA Topic//EN"? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer "-//OASIS//DTD LIGHTWEIGHT DITA Topic//EN". The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php -- --  Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201

The public identifier changed to XDITA because readers were understanding LwDITA as XML only.  He subcommittee has a more robust set of sample files in the GitHub repository and I plan to improve them as the TC and public review this draft of the note.  Carlos  On Sat, Jun 10, 2017 at 7:55 AM Kristen James Eberlein < kris@eberleinconsulting.com > wrote: Why the shift from "-//OASIS//DTD LW DITA Topic//EN" to "-//OASIS//DTD XDITA Topic//EN"? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer "-//OASIS//DTD LIGHTWEIGHT DITA Topic//EN". The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php -- --  Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201

By definition, DTDs ARE XML, so I think there is no more problem with the public identifier stating so. Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 6/10/2017 11:50 AM, Carlos Evia wrote: The public identifier changed to XDITA because readers were understanding LwDITA as XML only.  He subcommittee has a more robust set of sample files in the GitHub repository and I plan to improve them as the TC and public review this draft of the note.  Carlos  On Sat, Jun 10, 2017 at 7:55 AM Kristen James Eberlein < kris@eberleinconsulting.com > wrote: Why the shift from -//OASIS//DTD LW DITA Topic//EN to -//OASIS//DTD XDITA Topic//EN ? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer -//OASIS//DTD LIGHTWEIGHT DITA Topic//EN . The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php -- --  Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201

By definition, DTDs ARE XML, so I think there is no more problem with the public identifier stating so. Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 6/10/2017 11:50 AM, Carlos Evia wrote: The public identifier changed to XDITA because readers were understanding LwDITA as XML only.  He subcommittee has a more robust set of sample files in the GitHub repository and I plan to improve them as the TC and public review this draft of the note.  Carlos  On Sat, Jun 10, 2017 at 7:55 AM Kristen James Eberlein < kris@eberleinconsulting.com > wrote: Why the shift from -//OASIS//DTD LW DITA Topic//EN to -//OASIS//DTD XDITA Topic//EN ? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer -//OASIS//DTD LIGHTWEIGHT DITA Topic//EN . The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php -- --  Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201

The grammar files currently have the following names: map.mod, topic.mod map.dtd, topic.dtd highlightDomain.mod I'd suggest that the files be prefixed with lwdita- or xdita-. Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 6/10/2017 9:54 AM, Kristen James Eberlein wrote: Why the shift from -//OASIS//DTD LW DITA Topic//EN to -//OASIS//DTD XDITA Topic//EN ? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer -//OASIS//DTD LIGHTWEIGHT DITA Topic//EN . The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php

I agree with all Kris’ comments WRT the DTDs.   Cheers,   E.   -- Eliot Kimber http://contrext.com       From: <dita@lists.oasis-open.org> on behalf of Kristen James Eberlein <kris@eberleinconsulting.com> Date: Sunday, June 11, 2017 at 8:48 AM To: <dita@lists.oasis-open.org>, "dita-lightweight-dita@lists.oasis-open.org" <dita-lightweight-dita@lists.oasis-open.org> Subject: Re: [dita] Lightweight DITA: org.oasis.xdita, part II   The grammar files currently have the following names: map.mod, topic.mod map.dtd, topic.dtd highlightDomain.mod I'd suggest that the files be prefixed with lwdita- or xdita-. Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 6/10/2017 9:54 AM, Kristen James Eberlein wrote: Why the shift from "-//OASIS//DTD LW DITA Topic//EN" to "-//OASIS//DTD XDITA Topic//EN"? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer "-//OASIS//DTD LIGHTWEIGHT DITA Topic//EN". The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text.   -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php

The grammar files currently have the following names: map.mod, topic.mod map.dtd, topic.dtd highlightDomain.mod I'd suggest that the files be prefixed with lwdita- or xdita-. Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 6/10/2017 9:54 AM, Kristen James Eberlein wrote: Why the shift from -//OASIS//DTD LW DITA Topic//EN to -//OASIS//DTD XDITA Topic//EN ? In this context -- public identifiers for XML files -- there would be no confusion re other Lightweight DITA formats. I'd prefer -//OASIS//DTD LIGHTWEIGHT DITA Topic//EN . The plugin.xml file needs to be updated. I'm not sure who should be listed as the support person. The dita-comment list? dita-lightweight-dita-chair@lists.oasis-open.org ? For public consumption, I'd remove the docs directory -- unless we add something something there that is geared for public consumption, for example, directions on how to install the plugin and work with the sample files, or info about how the DTDs were coded. I'd like to see a more robust set of sample files; currently there is a DITA map and two topics. One topic -- programming-bulbs.dita - is solid, while topic-test.dita was clearly only intended to be used while developing the DTDs. The map references the two topics and defines a key, although the key has no @href or variable text. -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php