Skip to content

DOCSP-44951 TOC Relabel #144

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 3 commits into from
Nov 13, 2024
Merged

Conversation

lindseymoore
Copy link
Collaborator

@lindseymoore lindseymoore commented Nov 11, 2024

Pull Request Info

PR Reviewing Guidelines

JIRA - https://jira.mongodb.org/browse/DOCSP-44951
Staging - https://deploy-preview-144--docs-rust.netlify.app/

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?

Copy link

netlify bot commented Nov 11, 2024

Deploy Preview for docs-rust ready!

Name Link
🔨 Latest commit e411553
🔍 Latest deploy log https://app.netlify.com/sites/docs-rust/deploys/6734f318fb4260000831cc0f
😎 Deploy Preview https://deploy-preview-144--docs-rust.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Collaborator

@ltran-mdb2 ltran-mdb2 left a comment

Choose a reason for hiding this comment

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

Thanks for picking up this work @lindseymoore ! I left a couple suggestions to increase brevity and reduce duplication. Feel free to reach out if you have any questions!

Comment on lines 22 to 32
Find a Document </usage-examples/findOne>
Find Multiple Documents </usage-examples/find>
Insert a Document </usage-examples/insertOne>
Insert Multiple Documents </usage-examples/insertMany>
Update a Document </usage-examples/updateOne>
Update Multiple Documents </usage-examples/updateMany>
Replace a Document </usage-examples/replace>
Delete a Documents </usage-examples/deleteOne>
Delete Multiple Documents </usage-examples/deleteMany>
Count Documents </usage-examples/count>
List Distinct Field Values </usage-examples/distinct>
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
Find a Document </usage-examples/findOne>
Find Multiple Documents </usage-examples/find>
Insert a Document </usage-examples/insertOne>
Insert Multiple Documents </usage-examples/insertMany>
Update a Document </usage-examples/updateOne>
Update Multiple Documents </usage-examples/updateMany>
Replace a Document </usage-examples/replace>
Delete a Documents </usage-examples/deleteOne>
Delete Multiple Documents </usage-examples/deleteMany>
Count Documents </usage-examples/count>
List Distinct Field Values </usage-examples/distinct>
Find One </usage-examples/findOne>
Find Multiple </usage-examples/find>
Insert One </usage-examples/insertOne>
Insert Multiple </usage-examples/insertMany>
Update One </usage-examples/updateOne>
Update Multiple </usage-examples/updateMany>
Replace One </usage-examples/replace>
Delete One </usage-examples/deleteOne>
Delete Multiple </usage-examples/deleteMany>
Count </usage-examples/count>
List Distinct Values </usage-examples/distinct>

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Will rename parent section to 'CRUD Examples' to give more context when 'Document' is deleted.

Comment on lines +9 to +10
Connection Guide </fundamentals/connections/connection-guide>
Connection Options </fundamentals/connections/connection-options>
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
Connection Guide </fundamentals/connections/connection-guide>
Connection Options </fundamentals/connections/connection-options>
Guide </fundamentals/connections/connection-guide>
Options </fundamentals/connections/connection-options>

Copy link
Collaborator Author

@lindseymoore lindseymoore Nov 12, 2024

Choose a reason for hiding this comment

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

Would prefer to leave because it fits on one line. My reasoning is to provide the context in the TOC where possible when it becomes a title as vague as "Options" or "Guide". Think it burdens the user with additional cognitive load when they need to refer to the parent section name for context.

Comment on lines +10 to +12
Cluster Monitoring </fundamentals/monitoring/cluster-monitoring>
Command Monitoring </fundamentals/monitoring/command-monitoring>
Connection Monitoring </fundamentals/monitoring/connection-monitoring>
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
Cluster Monitoring </fundamentals/monitoring/cluster-monitoring>
Command Monitoring </fundamentals/monitoring/command-monitoring>
Connection Monitoring </fundamentals/monitoring/connection-monitoring>
Cluster </fundamentals/monitoring/cluster-monitoring>
Command </fundamentals/monitoring/command-monitoring>
Connection </fundamentals/monitoring/connection-monitoring>

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

^same reasoning as above. Would prefer to leave.

Comment on lines +16 to +17
Connection Troubleshooting </connection-troubleshooting>
Operation Error Handling </op-error-handling>
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
Connection Troubleshooting </connection-troubleshooting>
Operation Error Handling </op-error-handling>
Troubleshooting </connection-troubleshooting>
Error Handling </op-error-handling>

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Would prefer to leave. "Trouble shooting" and "error handling" could be synonymous without the additional context.

Copy link
Collaborator

@mongoKart mongoKart left a comment

Choose a reason for hiding this comment

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

lgtm w/ suggestions

@lindseymoore lindseymoore removed the request for review from sarahemlin November 13, 2024 18:43
Copy link
Collaborator

@sarahemlin sarahemlin left a comment

Choose a reason for hiding this comment

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

Approved with Lauren's changes and the ones Lindsey wanted to keep as-is. Thank you!

@lindseymoore lindseymoore merged commit 427afa7 into mongodb:master Nov 13, 2024
9 checks passed
github-actions bot pushed a commit that referenced this pull request Nov 13, 2024
(cherry picked from commit 427afa7)
github-actions bot pushed a commit that referenced this pull request Nov 13, 2024
(cherry picked from commit 427afa7)
Copy link

The backport to v2.8 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-v2.8 v2.8
# Navigate to the new working tree
cd .worktrees/backport-v2.8
# Create a new branch
git switch --create backport-144-to-v2.8
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 427afa7423d9ec861082e6a4d0b0a33f7f997980
# Push it to GitHub
git push --set-upstream origin backport-144-to-v2.8
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-v2.8

Then, create a pull request where the base branch is v2.8 and the compare/head branch is backport-144-to-v2.8.

Copy link

The backport to v2.7 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-v2.7 v2.7
# Navigate to the new working tree
cd .worktrees/backport-v2.7
# Create a new branch
git switch --create backport-144-to-v2.7
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 427afa7423d9ec861082e6a4d0b0a33f7f997980
# Push it to GitHub
git push --set-upstream origin backport-144-to-v2.7
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-v2.7

Then, create a pull request where the base branch is v2.7 and the compare/head branch is backport-144-to-v2.7.

lindseymoore added a commit to lindseymoore/docs-rust that referenced this pull request Nov 13, 2024
(cherry picked from commit 427afa7)
lindseymoore added a commit to lindseymoore/docs-rust that referenced this pull request Nov 13, 2024
(cherry picked from commit 427afa7)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants