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

Robert Kanter commented on OOZIE-1853:
--------------------------------------

Sure.  I'll just throw in an "amendment" patch to link those.

> Improve the Credentials documentation
> -------------------------------------
>
>                 Key: OOZIE-1853
>                 URL: https://issues.apache.org/jira/browse/OOZIE-1853
>             Project: Oozie
>          Issue Type: Sub-task
>          Components: docs
>    Affects Versions: 4.0.0
>            Reporter: Robert Kanter
>            Assignee: Robert Kanter
>             Fix For: trunk
>
>         Attachments: OOZIE-1853.patch, OOZIE-1853.patch, OOZIE-1853.patch
>
>
> We've heard from users that the Credentials documentation isn't very clear or 
> easy to find.  
> More specifically:
> # It's titled "Unified Credentials Module" which, to the user, isn't 
> super-obvious what it means.  Perhaps something like "Authenticating with 
> Other Components", "Action Authentication", etc would be more clear
> # The content of the page itself reads more like a design document; it 
> presents two options for solving the problem with their shortcomings.  It 
> would be better to restructure the page to only mention what we did do, and 
> make it more clear how to setup and use the Credentials.  
> #- The Sample implementation is nice to have, but it's for advanced users.  
> Most users would be interested in the last section of the page where we 
> briefly say how to enable the Credentials classes and the middle of the page 
> where we talk about UI changes.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to