[jira] [Commented] (COUCHDB-1952) How exactly are underscore-prefixed fields reserved?

["Alexander Shorin (JIRA)" <ji...@apache.org>]

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

Alexander Shorin commented on COUCHDB-1952:
-------------------------------------------

Both yes. You'll get self explain error response if you try to violate these rules.

> How exactly are underscore-prefixed fields reserved?
> ----------------------------------------------------
>
>                 Key: COUCHDB-1952
>                 URL: https://issues.apache.org/jira/browse/COUCHDB-1952
>             Project: CouchDB
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Nathan Vander Wilt
>
> The wiki stated "Note that any top-level fields within a JSON document containing a name that starts with a _ prefix are reserved for use by CouchDB itself." http://wiki.apache.org/couchdb/HTTP_Document_API#Special_Fields
> In the new documentation the closest equivalent I can find is the hand-wavy "As a general rule, URL components and JSON fields starting with the _ (underscore) character represent a special component or entity within the server or returned object." http://docs.couchdb.org/en/latest/api/index.html?highlight=underscore
> I'd like to see the official documentation clarified:
> - are underscore fields still reserved? (I'm assuming so.)
> - are they reserved only at the top level? (I'm hoping so.)



--
This message was sent by Atlassian JIRA
(v6.1#6144)