Skip to content

docs(site): move the reopen page to the end of the sidebar and skip the app build for site-only changes - #53

Merged
mayuki merged 2 commits into
mainfrom
claude/docs-nav-order-ci-config-66c4be
Nov 2, 2026
Merged

mayuki merged 2 commits into
mainfrom
claude/docs-nav-order-ci-config-66c4be

Conversation

@mayuki

@mayuki mayuki commented Nov 2, 2026

Copy link
Copy Markdown
Member

Summary

Two small changes around the documentation site.

Sidebar order

Reopening URLs with Preferis appeared between Profiles and Rules. It now comes last, after Sharing Configuration Across Devices:

Preferis → Installation → Quick Start → Configuration Files → Profiles → Rules → Sharing Configuration Across Devices → Reopening URLs with Preferis

The sidebar is autogenerated, and pages without sidebar_position sort after the numbered ones by file name, so giving only that page a large number would not move it to the end. Every top-level item is now numbered:

  • sidebar_position 4, 7 and 8 on Configuration Files, Sharing Configuration Across Devices and Reopening URLs with Preferis, in both the English and Japanese front matter
  • position 5 and 6 in profile/_category_.json and rule/_category_.json (category metadata is read from site/docs only, so the Japanese side needs no change)

site/README.md now says that new pages need a number in both languages.

App CI

build-debug.yaml now has paths-ignore for site/** and .github/workflows/publish-docs.yml on both push and pull_request, so a site-only change runs only publish-docs.yml. A change that also touches anything else still runs the full Windows and macOS build. main has no branch protection or required checks, so a skipped run does not leave a PR waiting. docs/Design.ja.md §4.4 and site/README.md describe the new behaviour.

The design docs under docs/ and the READMEs still trigger the app build; this PR only covers the documentation site.

Verification

  • pnpm typecheck: passed
  • pnpm build: English and Japanese both built; the generated sidebar in build/index.html and build/ja/index.html has the order above
  • Checked the Japanese sidebar on the dev server
  • Parsed build-debug.yaml and checked the push / pull_request triggers. Because this PR also changes build-debug.yaml and docs/, the app build still runs on it, so the skip itself shows up only on the next site-only PR

🤖 Generated with Claude Code

mayuki and others added 2 commits November 2, 2026 18:42
…site

The site is already built and checked by publish-docs.yml, so running the
Windows and macOS builds for a site-only push or pull request only costs
runner time. main has no required checks, so the skipped workflow does not
leave a pull request waiting.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ebar

Pages without sidebar_position sort after the numbered ones by file name,
which put the page between Profiles and Rules. Number every top-level page
and category so the order is explicit, and note in the site README that
new pages need a number in both languages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mayuki
mayuki merged commit 61bdc86 into main Nov 2, 2026
5 checks passed
@mayuki
mayuki deleted the claude/docs-nav-order-ci-config-66c4be branch November 2, 2026 09:46
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