Skip to content

[AAASM-4550] 📝 (docs): Tab install/config/docker alternatives - #248

Closed
Chisanan232 wants to merge 3 commits into
masterfrom
v0.0.1/AAASM-4550/install_config_tabs
Closed

[AAASM-4550] 📝 (docs): Tab install/config/docker alternatives#248
Chisanan232 wants to merge 3 commits into
masterfrom
v0.0.1/AAASM-4550/install_config_tabs

Conversation

@Chisanan232

@Chisanan232 Chisanan232 commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Description

Applies the site's existing pymdownx.tabbed content-tabs pattern (already used
correctly on quick-start.md for pip/uv) to the two remaining pages that show
genuine sequential alternatives as a single plain code block, and adds a
tab-title font-size override so tab labels read as a quiet control rather than a
heading.

  • docs/troubleshooting.md — the native-runtime install (pip vs. uv +
    maturin) is now === "pip" / === "uv" tabs. (AAASM-4558)
  • docs/guides/container-base-image.md — the two docker build
    invocations (default vs. pinned --build-arg SDK_VERSION=...) are now
    === "Default" / === "Pinned version" tabs. (AAASM-4559)
  • docs/stylesheets/aaasm-brand.css — adds an explicit smaller/tighter
    font-size for .tabbed-labels labels (was 100% theme default). (AAASM-4560)

Type of Change

  • 📚 Documentation update

Breaking Changes

  • No

Related Issues

Testing

  • Manual testing performed
  • No tests required (docs-only change; ci.yaml excludes docs/** so no CI runs)

mkdocs build --strict passes cleanly (0 warnings/errors). Confirmed in the
built HTML that both pages emit a tabbed-set with the expected <label>s
(pip/uv; Default/Pinned version) and that the new .tabbed-labels > label
font-size rule ships in the compiled aaasm-brand.css.

Checklist

  • Code follows project style guidelines
  • Self-review completed
  • Documentation updated if needed

Convert the two alternative ways to enable the native runtime (pip vs.
uv+maturin) from one plain bash block into pymdownx.tabbed pip/uv tabs,
matching quick-start's install pattern.

Refs AAASM-4558
Convert the default vs. pinned --build-arg SDK_VERSION docker build
invocations from one plain bash block into Default/Pinned version tabs.

Refs AAASM-4559
Add an explicit smaller/tighter font-size for pymdownx.tabbed tab labels
so short tab titles read as a quiet control rather than a heading.

Refs AAASM-4560
@Chisanan232

Copy link
Copy Markdown
Contributor Author

Superseded — Story AAASM-4550 is split into per-subtask PRs per this repo's one-PR-per-subtask convention: #246 (AAASM-4558, troubleshooting pip/uv tabs), #245 (AAASM-4559, container-base-image docker-build tabs), #247 (AAASM-4560, tab-title font-size). AAASM-4561 is a verification-only subtask (acceptance-check via mkdocs build --strict + mkdocs serve) with no code deliverable, so it needs no separate PR. This consolidated Story PR is redundant. Closing.

@Chisanan232
Chisanan232 deleted the v0.0.1/AAASM-4550/install_config_tabs branch July 13, 2026 12:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant