Large quantities of documentation are duplicated
-------------------------------------------------
Key: QPID-2725
URL: https://issues.apache.org/jira/browse/QPID-2725
Project: Qpid
Issue Type: Bug
Reporter: Martin Ritchie
Priority: Critical
Fix For: 0.7
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.
-
You can reply to this email to add a comment to the issue online.
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]
