[jira] [Commented] (OOZIE-1853) Improve the Credentials documentation

["Hadoop QA (JIRA)" <ji...@apache.org>]

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

Hadoop QA commented on OOZIE-1853:
----------------------------------

Testing JIRA OOZIE-1853

Cleaning local git workspace

----------------------------

{color:green}+1 PATCH_APPLIES{color}
{color:green}+1 CLEAN{color}
{color:red}-1 RAW_PATCH_ANALYSIS{color}
.    {color:green}+1{color} the patch does not introduce any @author tags
.    {color:red}-1{color} the patch contains 12 line(s) with tabs
.    {color:red}-1{color} the patch contains 1 line(s) with trailing spaces
.    {color:green}+1{color} the patch does not introduce any line longer than 132
.    {color:red}-1{color} the patch does not add/modify any testcase
{color:green}+1 RAT{color}
.    {color:green}+1{color} the patch does not seem to introduce new RAT warnings
{color:green}+1 JAVADOC{color}
.    {color:green}+1{color} the patch does not seem to introduce new Javadoc warnings
{color:green}+1 COMPILE{color}
.    {color:green}+1{color} HEAD compiles
.    {color:green}+1{color} patch compiles
.    {color:green}+1{color} the patch does not seem to introduce new javac warnings
{color:green}+1 BACKWARDS_COMPATIBILITY{color}
.    {color:green}+1{color} the patch does not change any JPA Entity/Colum/Basic/Lob/Transient annotations
.    {color:green}+1{color} the patch does not modify JPA files
{color:green}+1 TESTS{color}
.    Tests run: 1510
{color:green}+1 DISTRO{color}
.    {color:green}+1{color} distro tarball builds with the patch 

----------------------------
{color:red}*-1 Overall result, please check the reported -1(s)*{color}


The full output of the test-patch run is available at

.   https://builds.apache.org/job/oozie-trunk-precommit-build/1763/

> 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
>         Attachments: 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.2#6252)