qpid-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robbie Gemmell (JIRA)" <j...@apache.org>
Subject [jira] Updated: (QPID-2725) Large quantities of documentation are duplicated
Date Mon, 01 Nov 2010 09:55:24 GMT

     [ https://issues.apache.org/jira/browse/QPID-2725?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Robbie Gemmell updated QPID-2725:
---------------------------------

    Fix Version/s:     (was: 0.7)

Updating 'Fix For'  to Unknown on issues not targeted for 0.8

> 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
>
> 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:dev-subscribe@qpid.apache.org


Mime
View raw message