Keep the \"try it\" step on the site - #154
Merged
guanzhousongmicrosoft merged 1 commit intoAug 24, 2026
Merged
Conversation
The final acceptance run reached a working, queryable database following the site alone and reported that nothing had to be guessed -- but it deducted a point because completing the documented ""insert and read a document"" step required leaving documentdb.io for mongodb.com. The page said `mongosh` is not shipped and linked the official instructions, which is honest but leaves a hole in the one flow the page exists to demonstrate. Give the commands for the two paved-road targets inline, and keep the link for everything else. Both were run in clean containers first: Ubuntu 24.04 and Rocky 9 each install mongosh 2.10.0. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8df9084a-ccaf-432c-b015-2ccd8893a9d8
guanzhousongmicrosoft
approved these changes
Aug 24, 2026
guanzhousongmicrosoft
left a comment
guanzhousongmicrosoft
left a comment
Contributor
There was a problem hiding this comment.
Closes the last gap from the final acceptance run. Both mongosh install blocks were executed in clean Ubuntu 24.04 and Rocky 9 containers before documenting (2.10.0 in each). CI green.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The final cold acceptance run — a terminal-only newcomer, live site, real repository — reached a working queryable database and reported "I never had to guess." It scored 4/5, and the first deduction was this:
Change
Give the
mongoshinstall commands inline for the two paved-road targets, keeping the link to MongoDB's official instructions for every other platform.Verification
Both command blocks were run in clean containers before being documented:
\\
mongosh on Ubuntu 24.04
2.10.0
mongosh on Rocky 9
2.10.0
\\
130 tests,
tsc --noEmitandnext buildpass; all four new strings verified present in the rendered guide.