Re: [dita] Action items from 22 August 2017 meeting

Committed as: dita.oasis-open.org/spec/archSpec/base/example-key-definition-for-images-alt-text.dita

 

Best regards,

 

--Scott

 

From:
Kristen James Eberlein <>

Date: Wednesday, August 23, 2017 at 10:51 AM

To: Scott Hudson <>, DITA TC <>

Subject: Re: [dita] Action items from 22 August 2017 meeting

 

Scott, can you develop a topic that would be appropriate for

http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part3-all-inclusive/archSpec/base/examples-of-keys.html#examples_of_keys

2.3.4.10 Examples of keys

I think an appropriate title would be "Example: Key definitions for images and alternate text"

Best,

Kris

Kristen James Eberlein

Chair, OASIS DITA Technical Committee

Principal consultant, Eberlein Consulting

www.eberleinconsulting.com

+1 919 682-2290; kriseberlein (skype)

On 8/23/2017 12:42 PM, Scott Hudson wrote:

Per my action item, here is an example of alt text using keys for images:

<keydef keys="fg_weather-notams" href="" format="png">

    <topicmeta><linktext>Weather &amp; NOTAMs dialog box showing a station report</linktext></topicmeta>

</keydef>

 

This example incorporates the guidance from:

http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/processing-keyref-for-text.html

 

Otherwise, if <linktext> is specified inside of <topicmeta>, the contents of <linktext> are used as the effective content.

Note: Because all elements that get effective content will eventually look for content in the <linktext> element,
 using <linktext> for effective content is a best practice for cases where all elements getting text from a key definition should result in the same value.

 

Question: should this be added to the
dita.oasis-open.org/spec/archSpec/base/processing-keyref-for-text.dita topic, or are we managing errata02 differently?

 

Thanks and best regards,

 

--Scott

 

Voting member:

Boeing Data Standards Technical Advisory Board

OASIS DocBook TC, Publishers SC (Chair)

OASIS DITA TC, Tech Comm SC, LW DITA SC, Learning Content SC (Secretary)

OASIS DITA Adoption TC

OASIS Augmented Reality in Information Products (ARIP) TC

 

Scott Hudson

Content Strategist, Digital Aviation Learning and Development

Jeppesen, A Boeing Company

55 Inverness Drive East

Englewood, CO  80112

303-328-6228 | Cell: 303-350-7934

 

 

This document contains only administrative, uncontrolled data under U.S. International Traffic in Arms Regulations.

 

 

 

 

 

From:
<> on behalf of Kristen James Eberlein
<>

Date: Tuesday, August 22, 2017 at 3:30 PM

To: DITA TC <>

Subject: [dita] Action items from 22 August 2017 meeting

 

22 August 2017:

·        
Kris: Develop troubleshooting topic about what occurs if you don't filter out the notices platform="external-publishing" element (COMPLETED)

·        
Bob: Add Kris and Robert to list of committers for TechComm SC
 GitHub repo

·        
Carlos: Add Kris and Robert to list of committers for LwDITA SC GitHub repo

·        
Scott: Develop new example topic for errata 02 that covers alt text and using keys for images

·        
Eliot: Respond to George Bina's e-mail on dita-comment list

·        
Kris: Fix error in subjectScheme example (keys value "win98" vs. "winvis") for errata 02 (COMPLETED)

-- 

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