db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] [Comment Edited] (DERBY-6217) Put all of the security documentation in a single, separate user guide
Date Mon, 02 Jun 2014 17:10:02 GMT

    [ https://issues.apache.org/jira/browse/DERBY-6217?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14015568#comment-14015568
] 

Kim Haase edited comment on DERBY-6217 at 6/2/14 5:09 PM:
----------------------------------------------------------

Uploading DERBY-6217-fixptrs1.diff, DERBY-6217-fixptrs1.stat, and DERBY-6217-fixptrs1.zip,
the first of two patches to fix the pointers in the manuals that referred to the security
topics in the Admin Guide and Developer's Guide so that they point to the equivalent topics
in the Security Guide. This patch involves 4 topics in the Tools Guide, 2 topics in Getting
Started (including the doc list), and 76 topics in the Reference Manual.

None of these are actual xref elements, since they point to other manuals. The next patch
will include the changes to the Developer's Guide and Admin Guide themselves, so some of them
will be xrefs. This patch will also remove the obsolete topics in those two manuals.

I plan to commit this patch tomorrow, unless someone actually has the capacity for boredom
to review this and needs more time.


was (Author: chaase3):
Uploading DERBY-6217-fixptrs1.diff, DERBY-6217-fixptrs1.stat, and DERBY-6217-fixptrs1.zip,
the first of two patches to fix the pointers in the manuals that referred to the security
topics in the Admin Guide and Developer's Guide so that they point to the equivalent topics
in the Security Guide. This patch involves 4 topics in the Tools Guide, 2 topics in Getting
Started (including the doc list), and 76 topics in the Reference Manual.

None of these are actual xref elements, since they point to other manuals. The next patch
will include the changes to the Developer's Guide and Admin Guide themselves, so some of them
will be xrefs. The last step will be a patch that removes the obsolete topics.

I plan to commit this patch tomorrow, unless someone actually has the capacity for boredom
to review this and needs more time.

> Put all of the security documentation in a single, separate user guide
> ----------------------------------------------------------------------
>
>                 Key: DERBY-6217
>                 URL: https://issues.apache.org/jira/browse/DERBY-6217
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.11.0.0
>            Reporter: Rick Hillegas
>            Assignee: Kim Haase
>         Attachments: DERBY-6217-2.diff, DERBY-6217-3.diff, DERBY-6217-fixptrs1.diff,
DERBY-6217-fixptrs1.stat, DERBY-6217-fixptrs1.zip, DERBY-6217.diff, DERBY-6217.stat, DERBY-6217.zip
>
>
> Right now the security documentation is divided among our user guides. This makes is
hard for customers to understand Derby's defenses and how to configure all relevant security
mechanisms for an application. As demonstrated by the discussion on DERBY-6160, some security
mechanisms involve multiple Derby jar files and multiple application tiers. Material for these
mechanisms is scattered across the existing user guides. It would be less confusing if all
of Derby's security documentation were separated out into a new Security Guide.



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Mime
View raw message