Sorry for the silly response...I sent it not long after waking up. :-P
I do agree we need increasingly more clarity on the site, but I'd rather
not block longer. Trying to avoid the "perfect being the enemy of the good."
I tried several variations before sending this one--all more
accurate...and lengthy...than this one. What I determined was that *for
now* we should ship something *better* and iterate toward perfect. :)
The key necessary distinction to fix is between indexing and querying.
The rest, we'll continue to flesh out in the copy below the intro line,
and hopefully within a few weeks re-think the whole of the web
site--once we get farther on the "Why" conversations, etc.
The goal now is simply to "clean house" and make sure things are
clear*er*. :)
You all OK with me shipping this in the proposed way, and working our
way through the rest of the copy?
Hoping we can ship more, more often, and get to perfect a step at a time. :)
Thanks!
On 2/27/14, 7:08 AM, Benjamin Young wrote:
Yes. :)
Andy Wenk <[email protected]> wrote:
I expected that - but is it better to be pretty or better to be correct :)
I leave this to you :)
On 26 February 2014 23:34, Benjamin Young <[email protected]> wrote:
Yeah, it's a tricky balance. Adding that does make it clearer, but it also
makes that line too long and it wraps awkardly. :-P
On 2/26/14, 4:32 PM, Andy Wenk wrote:
Hey Benjamin,
shouldn't it read
"...
JavaScript for *creating* MapReduce indexes
...
"
then to make it even clearer?
Cheers
Andy
On 26 February 2014 17:40, Benjamin Young <[email protected]> wrote:
Hi all,
There's a larger effort to rethink/rewrite the CouchDB Website--which is
greatly needed, so super fabulous that we're endeavoring to do that. :)
Before we get there (or as we walk that road), there's some low hanging
fruit that I think we can and should pick first. I'd like to start at the
top, and work my way down a section at a time.
The first line on the website (ignoring navigation) reads this way
currently:
Apache CouchDB^(TM) is a database
that uses JSON for documents,
JavaScript for MapReduce queries,
and regular HTTP for an API
However, that's incorrect (JavaScript isn't used for querying) and has
confused many people--including some analysts and tech bloggers in the
wake
of the Cloudant/IBM announcement.
So, to correct this and make that section tighter, I'd like to propose
the
following:
Apache CouchDB^(TM) is a database
that uses JSON for documents,
JavaScript for MapReduce indexes
and regular HTTP for its API
Screenshot of this new text in place is here:
https://www.dropbox.com/s/ld6im36ql74jbo9/Screen%20Shot%
202014-02-26%20at%2011.22.21%20AM.png
Short: http://bit.ly/1mBwAmj
It's a small iteration (by design), but hopefully clears up the common
confusion around indexing vs. querying.
Thoughts welcome.
Thanks!
Benjamin
--
Andy Wenk
Hamburg - Germany
RockIt!
http://www.couchdb-buch.de
http://www.pg-praxisbuch.de
GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
https://people.apache.org/keys/committer/andywenk.asc
