[
https://issues.apache.org/jira/browse/DERBY-1590?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12484497
]
Laura Stewart commented on DERBY-1590:
--------------------------------------
Hmmm, I thought that when dita files were attached to issues before, that I was
able to open the files (or save them).
I can't with this one... I get an error.
Great, so we can have a separate issue for the "cleanup" of the files that are
not using the conrefs where they should be.
I'll continue to commit the patches for each book as you get them ready.
Don't worry about doing the Getting Started Guide, I will do that as I do the
merger :-)
> Consolidate the *conrefs.dita files in the documentation source tree to a
> single file.
> --------------------------------------------------------------------------------------
>
> Key: DERBY-1590
> URL: https://issues.apache.org/jira/browse/DERBY-1590
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.1.3.1, 10.2.1.6
> Reporter: Andrew McIntyre
> Assigned To: Kim Haase
> Fix For: 10.3.0.0
>
> Attachments: conrefs.dita, DERBY-1590-adminguide.diff,
> DERBY-1590-adminguide.stat, DERBY-1590.diff, DERBY-1590.stat
>
>
> Currently each book of the documentation contains its own conref file, which
> contains reusable content which can be included by reference in the
> documentation. These files, e.g. src/devguide/devconrefs.dita,
> src/getstart/gsconrefs.dita, should be consolidated to a single file,
> probably in the src directory, and the conref URLs updated to include a
> relative path up one level to the new file. This way, all of the manuals can
> share a single conref file and this content would not need to be duplicated.
> This would allow, for example, updating all the appropriate references to the
> version number in the documentation by updating a single file.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
