In its current form, couchapp.org is a relic that has been mostly abandoned and is not maintainable by the community. I strongly feel we should move the couchapp documentation into official documentation. I see two relevant points of interest in this discussion. First is the notion of couchapps as the self contained application platform that utilizes show/list functions, and whether these should be included in CouchDB. I don't think this is the important issue at hand.
The bigger issue is that the defacto method of defining design documents is to use one of the many "couchapp" tools, and the only place this is documented as a whole is couchapp.org. This is a disservice to the community, and one that needs to be resolved. This is a constant source of confusion to new users who quickly realize the futility of defining design docs in the browser, and get lost when told "just use a couchapp", and then they inevitably end up clicking on the top google result for "couchapp", couchapp.org. We need to have this properly documented in the official documentation so that the process is fully defined for new users. A couple of options for approach would be to formalize the folder definition of a couchapp and list tools known to be compatible, or to officially bless a tool like Erica. While I do want to see Fauxton provide powerful editors for all the different function types, I don't think this is sufficient as people typically want to keep their design docs raw code under SCM. Whatever approach is taken, I think the number one priority here is ensuring proper documentation explaining to users best practices for defining and maintaining design docs. -Russell On Sat, Nov 30, 2013 at 2:57 PM, Filippo Fadda < filippo.fa...@programmazione.it> wrote: > List and show are not stored procedure. We already discussed that Benoit. > > http://wiki.apache.org/couchdb/Formatting_with_Show_and_List > > From the documentation: "Show and list functions are side effect free and > idempotent. They can not make additional HTTP requests against CouchDB. > Their purpose is to render JSON documents in other formats." > > Apples are not pears. I'm not buying it, stop selling list and show like > stored proc. A stored procedure, in general, is not side effect free or > idempotent. > > > If you just want a database then any KV is enough for your purpose. If > now > > you want a DBMS which at least I want, then you probably want a way to > > store procedures and such to adapt the query language to your needs. > Guess, > > what is the purpose of lists and shows? > > Not in the way they are. To me, actually list and show are useless. I'm > sorry, this is what I think. Can we just move on? > > -Filippo
