[
https://issues.apache.org/jira/browse/QPID-2725?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Robbie Gemmell updated QPID-2725:
---------------------------------
Component/s: Documentation
> Large quantities of documentation are duplicated
> -------------------------------------------------
>
> Key: QPID-2725
> URL: https://issues.apache.org/jira/browse/QPID-2725
> Project: Qpid
> Issue Type: Bug
> Components: Documentation
> Reporter: Martin Ritchie
> Priority: Critical
>
> The way we generated documentation has led us to duplicate a large amount of
> contents which will be hard to maintain.
> This is because we have the ability to make 1 Book that includes all the
> documentation yet still make individual books.
> The problem is in the 1 Book scenario we need to use the <part> tag for
> content and in the individual books we need <book>
> The simple solution is to have the individual book include the <part> but we
> are not doing that, we are duplicating the code and in some cases we have an
> IDENTICAL file checked in twice: Qpid-Book.xml and Book.xml I'm looking at
> you.
> These individual books all have the same code as the files that don't have
> the -Book
> src/AMQP-Messaging-Broker-CPP-Book.xml
> src/Qpid-Compatibility-And-Interoperability-Book.xml
> src/AMQP-Messaging-Broker-Java-Book.xml
> They need updated to import the non -Book version or we will end up with in
> consistent documentation.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]
