Robert Kanter created OOZIE-1853:
------------------------------------

             Summary: Improve the Credentials documentation
                 Key: OOZIE-1853
                 URL: https://issues.apache.org/jira/browse/OOZIE-1853
             Project: Oozie
          Issue Type: Improvement
          Components: docs
    Affects Versions: 4.0.0
            Reporter: Robert Kanter
            Assignee: Robert Kanter


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)

Reply via email to