dita — archive
RE: [dita] Last call for top DITA issues
MHonArc v2.5.0b2 -->dita message
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [dita] Last call for top DITA issues
- From: Erik Hennum <[email protected]>
- To: "Jennifer Linton" <[email protected]>
- Date: Mon, 20 Feb 2006 09:13:59 -0800
Hi, Jen:
I think it's a reuse issue. Some information deliverables might use both ac-air and ac-electric. Others might use one or the other alone. So, we're better off letting the process collate and format the selected definitions rather than having writers manually assemble each glossary entry.
Down the road, one could imagine a process that
1. Builds a list of terms based on occurrences of <term> within the content
2. Pulls the definitions for those terms from a pool of available glossary definitions
3. Collates the definitions by term
4. Formats the definitions for publication
Thanks,
Erik Hennum
[email protected]
[email protected]>">"Jennifer Linton" <[email protected]>
02/20/2006 08:54 AM |
|
I may have missed this, but why would we not just have both definitions in the same entry as the term and apply ids or other clarifying metadata to each definition?
Jen
Jen Linton
Comtech Services, Inc.
Senior Consultant and Web Manager
710 Kipling St. Suite 400
Denver, CO 80215
P: 303-232-7586
F: 303-232-0659
skype: jenlinton
From: Erik Hennum [mailto:[email protected]]
Sent: Monday, February 20, 2006 9:43 AM
To: Esrig, Bruce (Bruce)
Cc: [email protected]; Paul Prescod
Subject: RE: [dita] Last call for top DITA issues
Hi, Bruce:
My apologies for neglecting to clarify the term concerns -- I think the existing glossary proposal already handles both the case where the same term has multiple senses:
<glossentry id="ac-air">
<glossterm>AC</glossterm>
<glossdef>Air conditioning</glossdef>
</glossentry>
...
<glossentry id="ac-electric">
<glossterm>AC</glossterm>
<glossdef>Alternating current</glossdef>
</glossentry>
It would be up to the processing to collate by term and format definitions on output.
The proposal also includes a <glsynonym> element to specify synonym terms with the same meaning.
If one of the themes of DITA 1.1 / DITA 1.0.5 is enabling books, I'm wondering whether the shortdesc enhancements would be important for the narrative glue.
Hoping that's interesting,
Erik Hennum
[email protected]
[email protected]>">"Esrig, Bruce (Bruce)" <[email protected]>
02/20/2006 03:49 AM |
|
1. How about a simple generalization of task to allow tables and graphics in parallel with steps.
That would leave the following compatible extensions for the future:
- the div elements
- nested steps
2. For glossary, I'd still like to close on the issue of terms with multiple senses. This was raised privately with Erik Hennum earlier, but I'd be glad to discuss it more broadly in case it could easily cause incompatible changes if we decided to tackle it after a simple glossary mechanism was already fielded.
Specifically, we have cases where a project uses the same term in multiple senses, and being able to gloss the correct sense would be really helpful. For example: AC := i. Air Conditioning, ii. Alternating Current. It's just an abbreviation, but I can imagine it happening with terms as well. Quick, define "interface" in a way that is specific enough to indicate how you mean it in three interesting contexts and yet not ambiguous when glossed. Fun challenge, right?
The opposite also happens: multiple terms for a single sense. This might be easy for DITA to handle because of conref.
Best wishes,
Bruce
====
To merge the threads ... JoAnn Hackos wrote:
Which index-related issues would you prioritize?
- #44 Keep indextermref (or redefine its function)
- #45 Add See, See Also indexing elements
- #45a Add sort order indexing elements
- #45b Add page range indexing elements
I wouldn't leave the others out if we can manage it.