define terminology for the various aspects of Dispatcher

• Key: FOR-639
• Type: Task
• Status: Open
• Priority: Minor
• Assignee: Unassigned
• Reporter: David Crossley
• Component/s: Documentation and website, Plugin: input.glossary, Plugin: internal.dispatcher
• Affects Version/s: 0.8
• Fix Version/s: 0.9-dev

Description

See the email thread:
http://marc.theaimsgroup.com/?t=112276643700001

Comments

[Gavin]

Not sure you need an .add file, but I did to then create the .diff

[Gavin]

Glossary File added, not complete but a start.
Site.xml changed to accomodate Glossary in 0.80 Versioned Docs section
glossary-to-document.xsl changed to tidy up the <td>'s to have a constant width throughout.

[David Crossley]

Added your patch for the initial Glossary, thanks. I needed to make some changes, so you might need to move your glossary.xml out of the way before doing 'svn update'. We use two-space indenting, not tabs, so i used Tidy to fix it. No content changes.

There were validation problems with glossary.xml file. These issues were noted as Todo items in the glossary plugin's status.xml file. I made a quick workaround to the glosarry DTD (see svn r393691) to enable multiple "see" and "definition" elements. Don't know if the xml needs better structure, e.g. <definitions><definition><definition>

Regarding the patch for glossary-to-document.xsl ... Wouldn't it be better to use CSS rather than td@width? Anyway we should address that as a separate general issue.

Will leave this issue open for a while in case there are more additions to the glossary, from you or other people. Thanks again.

[Gavin]

glossary-v10.mod - added <definitions> element.
glossary-to-document.xsl - added <definitions> template , fixed <see> elemnt to reference #anchor.

More to come.

[David Crossley]

Thanks, patches applied. I will follow up separately regarding a few comments that will help with your patches.

BTW, please keep the issues separate, e.g. this FOR-639 should be about the site-author/contents/xdocs/glossary.xml file and we should have separate issues for each particular enhancement to the Glossary Plugin itself.

[David Crossley]

The entries related to the Dispatcher need to move into the Dispatcher plugin docs.

[Gavin]

Added dispatcher-glossary.xml to plugin, enabled glossary plugin.

[Gavin]

glossary.xml.diff2 removes dispatcher related terms, these are now in the dispatcher-glossary.xml which resides in the dispatcher plugin instead.

[Thorsten Scherler]

I applied the latest patches (17/07/06) from Gavin. Thanks Gavin.

However the patches can be seen as setup of the infrastructure but are not resolving this issue.

We still need content for the glossary documentation.

[Thorsten Scherler]

Dispatcher will not leave the whiteboard till after 0.8

[Gavin]

Lowering Priority, this could probably be closed soon unless others have some items to add.