Make native packages a first-class onboarding path - #180
Open
GuanzhouSong wants to merge 2 commits into
Open
Conversation
Promote the modular Linux packages with a native-first homepage, guided install/setup/query flow, shareable install choices, and aligned documentation and launch content. Keep Docker accessible and surface release availability and pre-GA limitations. Copilot-Session: 83bd3e78-04a7-48ee-93bc-9f18517a4cf2 Signed-off-by: Guanzhou Song <guanzhousong@microsoft.com>
Use checked-in Getting Started markdown and navigation fixtures for article-service tests. CI runs tests before compiling the external docs tree, so a clean checkout must not depend on locally generated articles. Preserve the existing assertions and verify both navigation destinations exist. Copilot-Session: 83bd3e78-04a7-48ee-93bc-9f18517a4cf2 Signed-off-by: Guanzhou Song <guanzhousong@microsoft.com>
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
DocumentDB's new modular Linux packages make it possible to install the complete stack with apt or dnf and configure it through a setup wizard, while giving advanced users control over individual components. The website was still Docker-first, making this new native path harder to discover and try.
This PR makes packages a first-class entry point and guides new users from installation to their first query without taking away Docker or advanced PostgreSQL workflows.
Changes
The flow preserves explicit repository prerequisites, fresh-install/pre-GA limitations, credential guidance, and the distinction between package installation and setup.
Build environment
Dependency manifests and lockfiles are unchanged. The existing locked build is blocked locally by unavailable npm versions and missing locked Ruby gems; the complete static website, blog, and sitemap were generated using compatible local dependencies. npm downloads used the approved Microsoft package proxy.