Skip to content

docs: remove duplicated Board Operator entries from the docs navigation - #266

Open
claudegoogl-sudo wants to merge 1 commit into
masterfrom
docs/docs-nav-dedupe
Open

docs: remove duplicated Board Operator entries from the docs navigation#266
claudegoogl-sudo wants to merge 1 commit into
masterfrom
docs/docs-nav-dedupe

Conversation

@claudegoogl-sudo

Copy link
Copy Markdown
Owner

Follows CONTRIBUTING.md PR template — sections present: Thinking Path, Linked Issues or Issue Description, What Changed, Verification, Risks, Model Used, Checklist.

Thinking Path

  • Paperclip is the open source app people use to manage AI agents for work
  • The docs site's sidebar is generated from docs/docs.json (tabs → groups → pages)
  • The Guides → Board Operator group listed execution-workspaces-and-runtime-services and delegation twice each, back-to-back, so the rendered sidebar shows duplicate links to the same pages
  • This is a mechanical artifact of a list edit that appended without deduplicating; the pages themselves are correct
  • Removing the two duplicate list entries restores one sidebar link per page; no content changes
  • Documentation-nav hygiene only; zero product-code change

Linked Issues or Issue Description

No public issue tracks this; the defect is visible directly in the rendered sidebar (two identical entries under Guides → Board Operator).

What Changed

  • docs/docs.json: deleted two duplicate page entries from the Board Operator group (guides/board-operator/execution-workspaces-and-runtime-services, guides/board-operator/delegation). Net diff: 2 deleted lines; JSON validity and all other entries unchanged.

Verification

  • python3 -c duplicate-scan over all tabs/groups/pages: 2 duplicates before, 0 after.
  • git diff --stat: exactly 2 deletions, no other churn (formatting round-trips byte-identically).
  • CI runs the full verify matrix on this PR; the e2e shards render the app independently of docs nav, but the full lane still proves no generated-config consumer breaks.

Risks

  • Minimal: a 2-line list deduplication in a generated-sidebar manifest. Worst case is a missing sidebar entry if a scan were wrong — the post-fix scan shows all 26 other Board Operator entries retained exactly once.

Model Used

GLM via the Anthropic-compatible Claude Code endpoint (z.ai). Agentic coding session with tool use and extended reasoning; the session does not expose the exact GLM version string.

Checklist

  • I have included a thinking path that traces from project context to this change
  • I have specified the model used (with version and capability details)
  • I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work (docs-nav hygiene only)
  • I have searched GitHub for duplicate or related PRs and linked them above (none exist)
  • I have either (a) linked existing issues with Fixes: # / Closes: # / Refs: # OR (b) described the issue in-PR following the relevant issue template (option b)
  • I have not referenced internal/instance-local Paperclip issues or links (only public GitHub #NNN / github.com/claudegoogl-sudo/paperclip URLs)
  • My branch name describes the change (docs/docs-nav-dedupe) and contains no internal Paperclip ticket id or instance-derived details
  • I have run tests locally and they pass (duplicate scan: 0 remaining; JSON parses)
  • I have added or updated tests where applicable (N/A — 2-line nav manifest fix)
  • I have updated relevant documentation to reflect my changes (the sidebar manifest is the change)
  • I have considered and documented any risks above
  • All Paperclip CI gates are green (full verify matrix runs on this PR)
  • [N/A] Greptile is 5/5 with no open P2s, recommendations, or follow-ups (Greptile reviews the upstream repo; this fork-internal PR has no Greptile integration)

execution-workspaces-and-runtime-services and delegation were each listed
twice back-to-back in the Guides tab, rendering duplicate sidebar links.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
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