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

Xiao Chen commented on HADOOP-12951:
------------------------------------

Sorry about the delay here [~andrew.wang]. I've updated all related parts in 
patch 2, please let me know what you think. Thanks.

The auth page is majorly copied from the javadoc at the beginning of the 
classes ({{AuthenticationFilter}}, {{ZKSignerSecretProvider}}), with 
corrections by checking the actual code.
I hope we could have a way to auto-generate docs from class headers, but maybe 
that's not realistic at this point, unless we standardize that for all hadoop 
classes. Anyways, although the auth page has some redundant information, but I 
think its structure is good and easy to understand/find. So I manually 
fixed/updated related docs.

> Improve documentation on KMS ACLs and delegation tokens
> -------------------------------------------------------
>
>                 Key: HADOOP-12951
>                 URL: https://issues.apache.org/jira/browse/HADOOP-12951
>             Project: Hadoop Common
>          Issue Type: Improvement
>            Reporter: Xiao Chen
>            Assignee: Xiao Chen
>         Attachments: HADOOP-12951.01.patch, HADOOP-12951.02.patch
>
>
> [~andrew.wang] suggested that the current KMS ACL page is not very 
> user-focused, and hard to come by without reading the code.
> I read the document (and the code), and I agree. So this jira puts more 
> documentation to explain the current implementation.



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

Reply via email to