[
https://issues.apache.org/jira/browse/QPID-2725?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12885624#action_12885624
]
Martin Ritchie commented on QPID-2725:
--------------------------------------
Committed change for the src/AMQP-Messaging-Broker-Java-Book.xml to include the
Java.xml but other items still need reviewed.
> 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]
