Skip to content

DOCSP-33952: Atomic typos #319

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Nov 15, 2023

Conversation

norareidy
Copy link
Collaborator

@norareidy norareidy commented Nov 15, 2023

Pull Request Info

PR Reviewing Guidelines

JIRA - https://jira.mongodb.org/browse/DOCSP-33952
Staging - https://preview-mongodbnorareidy.gatsbyjs.io/golang/DOCSP-33952-atomic-typos/

Self-Review Checklist

  • Is this free of any warnings or errors in the RST?
  • Did you run a spell-check?
  • Did you run a grammar-check?
  • Are all the links working?
  • Are the facets and meta keywords accurate?

@norareidy norareidy marked this pull request as ready for review November 15, 2023 20:22
Copy link
Collaborator

@rustagir rustagir left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no blocking comments, but left suggestions

@@ -261,7 +261,7 @@ they are listed:

.. note::

If you don't need an AWS session token for the role you're
If you don't require an AWS session token for the role you're
authenticating with, omit the line containing ``AWS_SESSION_TOKEN`` .
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: remove extra space here

Suggested change
authenticating with, omit the line containing ``AWS_SESSION_TOKEN`` .
authenticating with, omit the line containing ``AWS_SESSION_TOKEN``.

an ordered representation of the documents in the collection so your MongoDB instance
does not need to perform the ordering for sorting operations in-memory.
an ordered representation of the documents in the collection, so your MongoDB instance
does not perform the ordering for sorting operations in-memory.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: keep a less formal tone

Suggested change
does not perform the ordering for sorting operations in-memory.
doesn't perform the ordering for sorting operations in-memory.

@@ -78,10 +83,10 @@ out a connection, the method returns a timeout error.
Connection Establishment
~~~~~~~~~~~~~~~~~~~~~~~~

The driver might block an method call if it needs to create a new
The driver might block an method call if it must create a new
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The driver might block an method call if it must create a new
The driver might block a method call if it must create a new

Comment on lines 89 to 90
When the driver must create a new connection to execute an
operation, the Context sets a timeout for the establishment process. The
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: must is unnecessary here

Suggested change
When the driver must create a new connection to execute an
operation, the Context sets a timeout for the establishment process. The
When the driver creates a new connection to perform an
operation, the Context sets a timeout for the establishment process. The

Comment on lines 34 to 35
If you must read and write to more than one document, use
:ref:`transactions <golang-transactions>`.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: change sentence

Suggested change
If you must read and write to more than one document, use
:ref:`transactions <golang-transactions>`.
To learn how to perform compound operations on more than one document
at a time, see the :ref:`Transactions <golang-transactions>` guide.

Comment on lines 82 to 83
To find and delete a document in separate transactions, call the
``findOne()`` method followed by the ``deleteOne()`` method.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: something about this sentence is awkward, separate

Suggested change
To find and delete a document in separate transactions, call the
``findOne()`` method followed by the ``deleteOne()`` method.
To find a document and delete it in separate operations, call the
``findOne()`` method followed by the ``deleteOne()`` method.

Comment on lines 171 to 172
To find and update a document in separate transactions, call
the ``findOne()`` method followed by the ``updateOne()`` method.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: see earlier comment

the ``InsertOne()`` method, or insert multiple documents using either
the ``InsertMany()`` or ``BulkWrite()`` method.
Before you can find, update, and delete documents in MongoDB, you must
insert those documents. You can insert one document using the ``InsertOne()``
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
insert those documents. You can insert one document using the ``InsertOne()``
insert those documents. You can insert one document by using the ``InsertOne()``

the ``InsertMany()`` or ``BulkWrite()`` method.
Before you can find, update, and delete documents in MongoDB, you must
insert those documents. You can insert one document using the ``InsertOne()``
method, or insert multiple documents using either the ``InsertMany()``
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
method, or insert multiple documents using either the ``InsertMany()``
method, or insert multiple documents by using either the ``InsertMany()``

@@ -22,5 +22,5 @@ If your MongoDB Server is running locally, you can use the connection string
``"mongodb://localhost:<port>"`` where ``<port>`` is the port number you
configured your server to listen for incoming connections.

If you need to specify a different hostname or IP address, see our Server
If you must specify a different hostname or IP address, see our Server
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: here, I think "want to" is more apt

Suggested change
If you must specify a different hostname or IP address, see our Server
If you want to specify a different hostname or IP address, see our Server

@norareidy norareidy merged commit 9b44ddd into mongodb:master Nov 15, 2023
@norareidy norareidy deleted the DOCSP-33952-atomic-typos branch November 15, 2023 21:41
norareidy added a commit that referenced this pull request Nov 15, 2023
* DOCSP-33952: Atomic typos

* tagging

* style guide edits

* more tagging

* vale

* RR feedback

(cherry picked from commit 9b44ddd)
norareidy added a commit that referenced this pull request Nov 15, 2023
* DOCSP-33952: Atomic typos

* tagging

* style guide edits

* more tagging

* vale

* RR feedback

(cherry picked from commit 9b44ddd)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants