Consolidate the Nix and MacOS install tabs - #61
Merged
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
3 tasks
djsauble
commented
Aug 5, 2026
| These instructions cover installing Flox on systems that already have | ||
| Nix installed: generic Nix, NixOS, and Determinate Nix. | ||
|
|
||
| **Generic Nix** |
Contributor
Author
There was a problem hiding this comment.
The "Generic Nix", "NixOS", and "Determinate Nix" sections are at the same heading level as the other section headings in this tab, which makes it hard to read. Perhaps we can leave this level formatted in bold, and put the sub-headings in italics, what do you think?
mkenigs
approved these changes
Aug 5, 2026
|
|
||
|
|
||
| Use the Flox installer for your system to allow some opinionated configuration of Nix, or use these "Nix (Generic)" instructions for full control of your Nix installation. | ||
| Use the Flox installer for your system to allow some opinionated configuration of Nix, or use these generic Nix instructions for full control of your Nix installation. |
Contributor
There was a problem hiding this comment.
I think all 3 of these sections could be one section
| Use the Flox installer for your system to allow some opinionated configuration of Nix, or use these "Nix (Generic)" instructions for full control of your Nix installation. | ||
| Use the Flox installer for your system to allow some opinionated configuration of Nix, or use these generic Nix instructions for full control of your Nix installation. | ||
| </Note> | ||
| **Install Nix** |
Contributor
There was a problem hiding this comment.
suggestion nonblocking: not sure if two sets of tabs will look weird, but I think it's hard to find the right information on this page. Could we add a second set of tabs under the intro section with Generic Nix/NixOS/home-manager etc as the tabs?
Contributor
Author
There was a problem hiding this comment.
Nested tabs do look kind of weird, but it's a lot of content so maybe that makes sense. I'll see what Claude can whip up.
djsauble
added a commit
that referenced
this pull request
Aug 5, 2026
Per review feedback on #61, replace the bold pseudo-headings in the MacOS and Nix tabs with real ##/### headings so Mintlify's tab-aware "On this page" rail navigates within each tab (## = install path, ### = variant within a path): * Nix tab: merge the fragmented "Generic Nix" / "Install Nix" run into one section whose intro links to "Install imperatively" and "Install declaratively"; add a three-card chooser routing to #generic-nix, #nixos, and #determinate-nix; drop the --- separators that the headings replace. * MacOS tab: promote "Pkg installer" and "Homebrew" to sections and move the shared sudo note and "replace an existing Nix installation" accordion above both, since they apply to either method. Verified with mint dev: the #nix anchor (get.flox.dev contract, now pinned with an explicit Tab id) still activates the tab on a fresh load, as do the new heading anchors; mint broken-links passes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Shrink the Install Flox page's tab row from 9 tabs to 6 and make the two largest tabs navigable: * Merge Nix (Generic), Nix (NixOS), and Nix (Determinate) into a single Nix tab (anchor #nix, which the get.flox.dev install script links to) with per-flavor sections and one shared verify/upgrade section. * Merge MacOS (Pkg) and MacOS (Homebrew) into a single MacOS tab and deduplicate the "replace an existing Nix installation" accordion. * Replace bold pseudo-headings with real ##/### headings so Mintlify's tab-aware "On this page" rail navigates within each tab (## = install path, ### = variant), and add a three-card flavor chooser to the Nix tab routing to #generic-nix, #nixos, and #determinate-nix. No instructions were removed — only reorganized and deduplicated. In-page anchor links (#nix-generic -> #nix) are updated, and the #nix deep link was verified with mint dev to still activate the tab on a fresh page load; mint broken-links passes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
djsauble
force-pushed
the
daniel/consolidate-install-tabs
branch
from
August 5, 2026 17:30
51c87a6 to
7d553ce
Compare
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.
Per spec review feedback on #57, the Install Flox page's tab row scrolls horizontally. This shrinks it from 9 tabs to 6:
#nix, which the get.flox.dev install script now links to when it detects an existing Nix), with per-flavor sections and one shared verify/upgrade section.No instructions were removed — only reorganized and deduplicated. In-page anchor links (
#nix-generic→#nix) are updated.#57 will be rebased on top of this branch so its Install Script tab and preview reflect the consolidated anchors.
🤖 Generated with Claude Code