couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Benoit Chesneau (JIRA)" <>
Subject [jira] [Created] (COUCHDB-1931) documentation on shows and lists in misleading
Date Fri, 15 Nov 2013 09:55:30 GMT
Benoit Chesneau created COUCHDB-1931:

             Summary: documentation on shows and lists in misleading
                 Key: COUCHDB-1931
             Project: CouchDB
          Issue Type: Bug
          Components: Documentation
            Reporter: Benoit Chesneau

The doc says for the shows:

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

and later for the lists:

While Show functions are used to customize document presentation, List functions are used
for same purpose, but against View functions results.

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

View raw message