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 <ehennum@us.ibm.com>
- To: "Jennifer Linton" <jennifer.linton@comtech-serv.com>
- 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
ehennum@us.ibm.com
"Jennifer Linton" <jennifer.linton@comtech-serv.com>
"Jennifer Linton" <jennifer.linton@comtech-serv.com>
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:ehennum@us.ibm.com]
Sent: Monday, February 20, 2006 9:43 AM
To: Esrig, Bruce (Bruce)
Cc: dita@lists.oasis-open.org; 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
ehennum@us.ibm.com
"Esrig, Bruce (Bruce)" <esrig@lucent.com>
"Esrig, Bruce (Bruce)" <esrig@lucent.com>
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.
-----Original Message-----
From: Erik Hennum [mailto:ehennum@us.ibm.com]
Sent: Friday, February 17, 2006 6:39 PM
To: Paul Prescod
Cc: dita@lists.oasis-open.org
Subject: Re: [dita] Last call for top DITA issues
Hi, Paul:
As Don was pointing out to me today, the <data> element presumably rides in on the coat tails of bookmap because the book metadata depends on it, but that should be okay because <data> is good to go (unless anyone has thought of ways to improve it while it has been sitting on ice).
Does glossary also ride in with bookmap as a requirement for having a complete book story?
Any other hangers on?
Thanks,
Erik Hennum
ehennum@us.ibm.com
"Paul Prescod" <paul.prescod@blastradius.com>
"Paul Prescod" <paul.prescod@blastradius.com>
02/17/2006 03:22 PM
|
|
So the current list of proposals is:
#20 Extensible metadata attributes
* customers ask for it and the current situation is just not
workable for many
#38 Bookmap / bkinfo revision
* in widespread quasi-standard use already
* often requested by customers
#35 Support foreign content vocabularies such as MathML and SVG
* MathML in particular is very popular, and has been hacked by
XMetaL customers
* graphic (image) scaling improvements (no issue number?)
Now is the time to jump in with any other DITA 1.1 issue that you
consider absolutely urgent and therefore a candidate for "early
release".
And then SOME STILL-TO-BE-RANKED SUBSET of indexing requirements:
- #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'll send another email about ranking the indexing requirements.
Paul Prescod
[attachment "graycol.gif" deleted by Erik Hennum/Oakland/IBM] [attachment "ecblank.gif" deleted by Erik Hennum/Oakland/IBM]
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]