Archive - 2006
Incremental builds
Book page: Submitted by jelovirt on Thu, 2006-04-27 18:50. Last updated on Sat, 2012-06-16 10:15.
Note: this request should be raised as a issue at https://github.com/dita-ot/dita-ot/issues if the need still exists.
Eclipse integration
Book page: Submitted by robander on Thu, 2006-04-27 18:49. Last updated on Fri, 2008-03-21 15:04.
Note: This design information has not been updated since original creation, and should no longer be considered up to date. Up to date information on the toolkit can be found here: The DITA Open Toolkit
DITA OT 1.3 Issues tracking
Book page: Submitted by robander on Thu, 2006-04-27 17:52. Last updated on Fri, 2008-03-21 15:16.
NOTE: Version 1.3 was released in 2006. This information should no longer be considered up to date. Up to date information on the toolkit can be found here: The DITA Open Toolkit
SourceForgePatch1326450
Book page: Submitted by robander on Thu, 2006-04-27 17:43. Last updated on Fri, 2008-03-21 14:04.
Design document for SourceForge Patch #1326450 "Make ${basedir} mine"
NOTE: This design is for a patch that was included in the DITA-OT several releases ago. This should no longer be considered the latest information.
Design Description:
Alex
dynamic reuse
Blog entry: Submitted by Alex on Fri, 2006-04-21 19:11.
the current version of DITA data model supports several complementary implementation of reusing data.
reuse of topic as complete information object
conref to reuse within fine structure of an information object (useful for common used structures like warnings)
and profiling of information objects.
all of these methods are static, means the reused content cannot be adopted even if life cycle of information requires this (thats what ann rockley called a locked reuse).
if you talk about the life cycle of information this kind of reuse has strong limitation. if you want to "reuse" a use case provided by a analyst / software developer into a task (which would be very common) you have to force the analyst to specify in a way further usage of this use case (information object) can be provided as is.
thats has one major drawback. the analyst must focus on the specification and must provide information in a way the engineering team can work with. if he spend to much time in generalize the information object his skills are "wasted" and overall ROI will not be positive.
on the other hand the information created by the analyst must be adopted for service documentation, training documentation, user documentation.....means the use-case and corresponding topic in user documentation are the "same" information object from an information architectural point of view.
each time the use case changed the associated user documentation task must be adopted or at least approved.
this kind of approach can be perfect supported by a "dynamic reuse" or ann rockley would call it "derivative reuse". this means that the content of the information object is copied into the derived information object but there is still a connection to the information provider available. thus connection can be used to provide processing support for "dynamic reuse" e.g. an change notification each time the information provider changed, .....
what needs to be done to introduce dynamic reuse in DITA. a special kind of attribute is required which maintain the link to the information provider. this attribute must be specified (e.g. dynref) as well as the associated elements the attribute is required. similar to conref. the semantic of this reference must be specified as well.
thats simple for a standardization point of view, but provides many advantages. if this is standardized all people working on the processing chain (incl. DITA OT) can provide / improve support for this and somehow in the future most tool vendors implemented support for this.
in my personal point of view this is the missing gap in most information architectures that everything is based on static reuse. thus the life cycle of information objects are limited and therefore the usage of information objects are as well limited.
feedback welcome,
Alex
reuse of topic as complete information object
conref to reuse within fine structure of an information object (useful for common used structures like warnings)
and profiling of information objects.
all of these methods are static, means the reused content cannot be adopted even if life cycle of information requires this (thats what ann rockley called a locked reuse).
if you talk about the life cycle of information this kind of reuse has strong limitation. if you want to "reuse" a use case provided by a analyst / software developer into a task (which would be very common) you have to force the analyst to specify in a way further usage of this use case (information object) can be provided as is.
thats has one major drawback. the analyst must focus on the specification and must provide information in a way the engineering team can work with. if he spend to much time in generalize the information object his skills are "wasted" and overall ROI will not be positive.
on the other hand the information created by the analyst must be adopted for service documentation, training documentation, user documentation.....means the use-case and corresponding topic in user documentation are the "same" information object from an information architectural point of view.
each time the use case changed the associated user documentation task must be adopted or at least approved.
this kind of approach can be perfect supported by a "dynamic reuse" or ann rockley would call it "derivative reuse". this means that the content of the information object is copied into the derived information object but there is still a connection to the information provider available. thus connection can be used to provide processing support for "dynamic reuse" e.g. an change notification each time the information provider changed, .....
what needs to be done to introduce dynamic reuse in DITA. a special kind of attribute is required which maintain the link to the information provider. this attribute must be specified (e.g. dynref) as well as the associated elements the attribute is required. similar to conref. the semantic of this reference must be specified as well.
thats simple for a standardization point of view, but provides many advantages. if this is standardized all people working on the processing chain (incl. DITA OT) can provide / improve support for this and somehow in the future most tool vendors implemented support for this.
in my personal point of view this is the missing gap in most information architectures that everything is based on static reuse. thus the life cycle of information objects are limited and therefore the usage of information objects are as well limited.
feedback welcome,
Alex
----