Uh oh!
There was an error while loading. Please reload this page.
Finish wiring up the kubernetes-operator section - #63
Merged
guanzhousongmicrosoft merged 1 commit intoAug 3, 2026
Merged
Conversation
Two loose ends from documentdb#62, both created by pull requests that merged independently of it and could not have known about each other. The contributing instructions in readme.md list the folders that hold documentation articles, and documentdb#35 wrote that list while documentdb#62 was still open, so it names four folders where there are now five. A contributor following it would not know the kubernetes-operator section exists or that it follows the same rules. The documentdb-local page had no route onward. Someone who has just run the container and wants replication, failover, or rolling upgrades has no reason to guess that the answer is a different section of the site; it is the most likely place in these docs for that question to occur, so it now points at the operator section and at the pre-built packages. This was deliberately held back while documentdb#61 was rewriting that page, and lands now that it has merged.
guanzhousongmicrosoft
approved these changes
Aug 3, 2026
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 freeto 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.
Summary
Two loose ends from #62. Both exist because pull requests merged independently of each other and could not have known about each other — neither is a defect in the PRs that created them.
The contributing instructions name four folders where there are five
#35 added the Articles section to
readme.md, listing the folders that hold documentation articles. It was written while #62 was still open, so/kubernetes-operatoris missing from the list even though it is now a section like any other, with anavigation.ymland the same front matter requirements. A contributor following those instructions would not know it exists.The documentdb-local page has no route onward
Someone who has just run the container and now wants replication, failover, or rolling upgrades has no reason to guess that the answer lives in a different section of the site. That page is the most likely place in these docs for the question to come up, so it now points at the operator section and at the pre-built packages.
This was deliberately held back while #61 was rewriting
documentdb-local/index.md, to avoid handing that PR a conflict. #61 has merged, so it lands now.