[DOCS-7015] Comment on: "manual/applications/data-models-tree-structures.txt" Created: 21/Jan/16  Updated: 30/Oct/23  Resolved: 01/Nov/22

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: Server_Docs_20231030

Type: Bug Priority: Major - P3
Reporter: Docs Collector User (Inactive) Assignee: Unassigned
Resolution: Won't Fix Votes: 0
Labels: bite-sized, docs-triage
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Location: https://docs.mongodb.org/manual/applications/data-models-tree-structures/
User-Agent: Mozilla/5.0 (X11; Linux i686) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/46.0.2490.80 Safari/537.36
Referrer: https://docs.mongodb.org/manual/core/data-model-design/
Screen Resolution: 1920 x 1080
repo: docs
source: applications/data-models-tree-structures


Participants:
Days since reply: 1 year, 14 weeks, 1 day ago
Epic Link: DOCSP-1769
Story Points: 0.25

 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...



 Comments   
Comment by Education Bot [ 01/Nov/22 ]

Hello! This ticket has been closed due to inactivity. If you believe this ticket is still important, please reopen it and leave a comment to explain why. Thank you!

Generated at Thu Feb 08 07:53:25 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.