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

Sean Busbey commented on HDFS-12251:
------------------------------------

Another thing missing from the docs as they are in v2:

from Steve L on HDFS-11644:

{quote}
I don't want an enum though, I'd like a string. Why? Let's us and 
implementation classes add new methods without renegotiating the source tree. 
For example, on S3a, I could add the new attributes "s3a:delayed-commit", 
blobstore:put-on-close ( the latter being something which other blobstores 
could also do), etc. Some convention that for store-specific options, we use a 
prefix, so as to stop incompatibilities.
{quote}

The docs should call out that the options from store implementations should use 
a prefix. Preferably also state a suggested place implementors should doc the 
options they provide (based on whatever we do for documenting the stores in 
HADOOP-14402)

> Add document for StreamCapabilities
> -----------------------------------
>
>                 Key: HDFS-12251
>                 URL: https://issues.apache.org/jira/browse/HDFS-12251
>             Project: Hadoop HDFS
>          Issue Type: Improvement
>    Affects Versions: 3.0.0-alpha4
>            Reporter: Lei (Eddy) Xu
>            Assignee: Lei (Eddy) Xu
>             Fix For: 2.9.0, 3.0.0-beta1
>
>         Attachments: HDFS-12251.00.patch, HDFS-12251.01.patch, 
> HDFS-12251.02.patch
>
>
> Update filesystem docs to describe the purpose and usage of 
> {{StreamCapabilities}}.



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: hdfs-issues-unsubscr...@hadoop.apache.org
For additional commands, e-mail: hdfs-issues-h...@hadoop.apache.org

Reply via email to