[DOCS-2645] Comment on: "manual/core/read-operations.txt" Created: 03/Feb/14  Updated: 11/Apr/14  Resolved: 24/Mar/14

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: v1.3.3

Type: Improvement Priority: Major - P3
Reporter: Mathieu Poumeyrol Assignee: Sam Kleinman (Inactive)
Resolution: Done Votes: 0
Labels: collector-298ba4e7
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Location: http://docs.mongodb.org/manual/core/read-operations/
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/32.0.1700.77 Safari/537.36
Referrer: http://docs.mongodb.org/manual/core/cursors/
Screen Resolution: 1920 x 1200
repo: docs
source: core/read-operations


Issue Links:
Related
is related to DOCS-2989 Add Developer Content to Manual Intro... Closed
is related to DOCS-3121 Rework the "MongoDB CRUD Introduction... Closed
Participants:
Days since reply: 9 years, 47 weeks, 2 days ago

 Description   

Once again, this is a followup on a IRC discussion and attempt at helping a begginner.

I am having a very hard time pointing somebody to the right place for reading about use of the dot notation in a query selector context. IIRC it was covered in the old "getting started" page which i am unable to find now.

On a more general note, I think "hiding" the regular find() operator in CRUD/read is counter productive, even if it is somehow logical. I would personally make use of the regular find() a top level "regular read" subject, and make the rest of CRUD a top level "write ops" topic at the same level.

My memory of learning SQL — back last millenary — was about focusing on building increasingly complex select operations before starting with update and insert.



 Comments   
Comment by Sam Kleinman (Inactive) [ 24/Mar/14 ]

I'm going to go ahead and close this issue for the moment:

  • I've added some cross references that should help address the fact that it's hard to find the pages about queries and find().
  • we have an ongoing project to rewrite the getting started section, a "primer", to address the new user learning curve in a more directed sort of way.
  • I've also filed DOCS-2989, which I think further hides this kind of content from the very starting points in the manual.

Cheers,
sam

Comment by Githook User [ 24/Mar/14 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-2645: adding additional cross references
Branch: master
https://github.com/mongodb/docs/commit/5e79db90c17536aca2343547057456d19b2fe23f

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