[ 
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)

Reply via email to