You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2012/09/27 17:28:07 UTC

[jira] [Commented] (DERBY-1721) DOCS - Retitle topics with duplicate titles in Dev Guide re: Encryption

    [ 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