Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-7015

Comment on: "manual/applications/data-models-tree-structures.txt"

    XMLWordPrintableJSON

Details

    Description

      My 2c as a beginner on this material...

      Change the example scenario to be something unrelated to what is being learned. By that I mean instead of a tree with nodes that happen to relate to what is being learned... "MongoDB", "Databases", choose something completely unrelated. I would suggest "United States", "California", "San Francisco". That is better for two reasons. 1. A novice will not be confused when seeing "MongoDB" is quotes and wondering if that is a call or something related to the function of the database. 2. Users know the natural hierarchy of country-state-city. When looking through the json document, they don't need to refer back to the document, and say, oh yeah, "Programming" is a child of "Books" (not a natural relationship they would immediately know). It makes it faster to grok what is going on when comparing the json documents. 2b. Don't choose a node name that is plural. "Databases" may confuse the novice that it is itself referring to something that has an array of multiple instances, rather than just being a singleton string. That is my 2c as someone coming from RDBMS side...

      Attachments

        Activity

          People

            Unassigned Unassigned
            xgen-internal-docs Docs Collector User (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:
              1 year, 14 weeks, 1 day ago