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] [Commented] (DERBY-1721) DOCS - Retitle topics with duplicate titles in Dev Guide re: Encryption
Date Thu, 27 Sep 2012 15:28:07 GMT

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

Kim Haase commented on DERBY-1721:
----------------------------------

The section "Working with the database connection URL attributes" should point to "Encrypting
databases on disk" for information on database encryption, since the latter section is the
one cited by the Reference Manual topics on encryption.

The information in "Encrypting a database when you create it" and "Creating an encrypted database
with an external key" should be added to "Encrypting databases on creation". (The term "external
key" is not used in the Reference Manual. Is it meaningful?)

Any duplicate information in the first "Booting an encrypted database" should be added to
the second one.
                
> DOCS - Retitle topics with duplicate titles in Dev Guide re: Encryption
> -----------------------------------------------------------------------
>
>                 Key: DERBY-1721
>                 URL: https://issues.apache.org/jira/browse/DERBY-1721
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.2.1.6, 10.2.2.0, 10.3.1.4
>            Reporter: Laura Stewart
>            Assignee: Kim Haase
>            Priority: Minor
>
> In the Developers Guide. there are 2 sections that contain information about encryption.

> In some cases there are topics with different content but with the same titles. 
> There should not be duplicate titles in the Derby documentation.
> There is this section: 
> JDBC applications and Derby basics -->Derby embedded basics -->Working with the
database connection URL attributes 
> that has these topic titles: 
> --Using the databaseName attribute 
> --Shutting down Derby or an individual database 
> --Creating and accessing a database 
> --Providing a user name and password 
> --Encrypting a database when you create it 
> --Booting an encrypted database 
> --Specifying attributes in a properties object 
> Then there is this section: 
> Derby and Security -->Encrypting databases on disk -->Working with encryption 
> that has these topic titles: 
> --Encrypting databases on creation 
> --Creating the boot password 
>    --Specifying an alternate encryption provider 
>    --Specifying an alternate encryption algorithm 
> --Booting an encrypted database 
> --Changing the boot password 
> Someone needs to look at the content of these files, rework the information and necessary,
create the related links, and then retitle the topics to avoid duplicate titles.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message