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

["Robert Kanter (JIRA)" <ji...@apache.org>]

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)