Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-749

Could you please pay attention to what you write and find someone who can write CORRECT English to review it?

    XMLWordPrintable

Details

    Description

      There are a lot of grammatical errors and ill-formed sentences in the documentation which can really discredit your product!
      Just several example to illustrate my point:
      (Ctrl+F to find the following example in the documentation )

      1. you can choose whether to the reduce the...
      2. For information on how to write map functions, and how the output of the map function affects and supports searching. This is not a complete sentence! It makes a reader confused!
      3. mapping between the input fileds of the individual objects stored whithin Couchbase to the information ouput when the view is accessed. "mapping between sth. to sth"? It should be "mapping between sth. and sth".
      4. This can be useful when you want to supporting...
      5. if you elect to output fields in from the source JSON..,

      and so on...

      I hope that your team can really pay attention to these details and try to publish something credible. Because most of the developper will not dig into the source code to know how it works but read your documentation, if this is something ill-formed, I don't think the developer will continue to use your product. As far as I know, some similar NoSQL database like MongoDB, they have documentations of high quality!

      Reporter: Xingxian LI
      E-mail: glixingxian@gmail.com

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            akurtzman Amy Kurtzman (Inactive)
            docsite-collector Docs Site Collector
            Votes:
            0 Vote for this issue
            Watchers:
            6 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty