Return-Path: Delivered-To: apmail-db-derby-dev-archive@www.apache.org Received: (qmail 3767 invoked from network); 26 Mar 2007 18:59:58 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 26 Mar 2007 18:59:58 -0000 Received: (qmail 89641 invoked by uid 500); 26 Mar 2007 19:00:02 -0000 Delivered-To: apmail-db-derby-dev-archive@db.apache.org Received: (qmail 89624 invoked by uid 500); 26 Mar 2007 19:00:02 -0000 Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: Delivered-To: mailing list derby-dev@db.apache.org Received: (qmail 89610 invoked by uid 99); 26 Mar 2007 19:00:02 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 26 Mar 2007 12:00:02 -0700 X-ASF-Spam-Status: No, hits=-100.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO brutus.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 26 Mar 2007 11:59:52 -0700 Received: from brutus (localhost [127.0.0.1]) by brutus.apache.org (Postfix) with ESMTP id 7CB0C714066 for ; Mon, 26 Mar 2007 11:59:32 -0700 (PDT) Message-ID: <15282132.1174935572508.JavaMail.jira@brutus> Date: Mon, 26 Mar 2007 11:59:32 -0700 (PDT) From: "Laura Stewart (JIRA)" To: derby-dev@db.apache.org Subject: [jira] Commented: (DERBY-1590) Consolidate the *conrefs.dita files in the documentation source tree to a single file. In-Reply-To: <21492968.1153871473826.JavaMail.jira@brutus> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org [ https://issues.apache.org/jira/browse/DERBY-1590?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12484188 ] Laura Stewart commented on DERBY-1590: -------------------------------------- In thinking on it more, perhaps we should just stick with the current issue and create another issue to clean up any text which does not have the conrefs applied to it. > 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 > 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.