hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Xiao Chen (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HADOOP-12951) Improve documentation on KMS ACLs and delegation tokens
Date Fri, 01 Apr 2016 06:47:25 GMT

    [ 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

View raw message