couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Newson (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (COUCHDB-1931) documentation on shows and lists in misleading
Date Fri, 15 Nov 2013 10:59:21 GMT

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

Robert Newson commented on COUCHDB-1931:
----------------------------------------

"ask to some of the cloudant customer and you will see that some people are using them for
other cases"

I'm well aware of what our customers do with show/lists, it doesn't mean that it's the right
thing or even a good thing (it usually isn't).

My advice on show/list is from experience.

> documentation on shows and lists in misleading
> ----------------------------------------------
>
>                 Key: COUCHDB-1931
>                 URL: https://issues.apache.org/jira/browse/COUCHDB-1931
>             Project: CouchDB
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Benoit Chesneau
>
> The doc says for the shows:
> {quote}
> Show functions are used to represent documents in various formats, commonly as HTML page
with nicer formatting. They can also be used to run server-side functions without requiring
a pre-existing document.
> {quote}
> and later for the lists:
> {quote}
> While Show functions are used to customize document presentation, List functions are
used for same purpose, but against View functions results.
> {quote}
> We shouldn't speak of rendering or not only. Shows are about transforming the results
depending on the parameters you pass on the URL. Rendering is just one of the possibilities
due to the ability of transforming and editing the result(s). 
> We should make it more clear.



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

Mime
View raw message