bean5 opened a new issue #539:
URL: https://github.com/apache/couchdb-documentation/issues/539


   When I read CouchDB documentation, I'm flooded in by extra verbiage that 
doesn't need to be there and too much information. It is okay to mention that 
in reality there are 1600 nodes in a B-tree, but if I understand the need for 
Big-O of n * Log(n), I probably know that trees can get large and deep.
   
   Is the intended audience someone who is maintaining this source code or 
someone learning CouchDB?
   
   For a project to grow, it seems more important to be written for the CouchDB 
beginner than for the maintainer so you can gain traction, especially when 
there is tight competition.
   
   Frankly, I am worried. I am worried that CouchDB is simply going to lose 
over time against Firebase not because its technology is worse, but because 
Firebase's documentation was quick to follow and made it clear that it takes: 
~5 lines to set up, ~5 lines to do a write, and ~10 lines to so a search. 
Meanwhile with CouchDB I'm still busy reading about nodes and realizing that 
documentation is out of date.
   
   See also: #538


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to