[jira] [Commented] (DERBY-5928) Add more task focus to Derby security documentation

["Kim Haase (JIRA)" <ji...@apache.org>]

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

Kim Haase commented on DERBY-5928:
----------------------------------

The section "Configuring security for your environment" has lists of tasks that are somewhat different depending whether you are in embedded or client-server mode. I assume these differences are current and valid and that the list of tasks should be different for the two modes. Please let me know if any changes are needed here.

The major work involved in this documentation, I believe, is to flip the contents of the "Derby and security" and "Configuring security for your environment" sections of http://db.apache.org/derby/docs/dev/devguide/, rework them slightly, and add links to further information to the "Configuring security for your environment" sections. The remaining sections can probably remain as is.

Further information is to be found in both the Reference Manual and the Admin Guide.

The first topic, "Derby and security", should be titled "Configuring security for Derby" and should rework the contents of "Configuring security for your environment" and its two subsections.

The next topic should be "Derby security concepts" and should use the material from the original "Derby and security" topic.

The other topics should probably remain the same, although additional tweaks are possible.
  Working with user authentication
  Users and authorization identifiers
  User authorizations
  Encrypting databases on disk
  Signed jar files
  User authentication and authorization examples
  Running Derby under a security manager
                
> Add more task focus to Derby security documentation
> ---------------------------------------------------
>
>                 Key: DERBY-5928
>                 URL: https://issues.apache.org/jira/browse/DERBY-5928
>             Project: Derby
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions: 10.9.1.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>
> It has been recommended that the Derby security documentation in the Developer's Guide should have more of a task-based focus: instead of beginning with an outline of security concepts and then describing the tasks a user or administrator should perform to secure Derby, we should begin with a list of the steps required for security, with links to details on how to perform them, and cover the concepts after that. Users should have a single location where they can verify that they have done everything they can to ensure database security.

--
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