paperclipai/paperclip-docs
1
0 Fork 0
mirror of https://github.com/paperclipai/paperclip-docs.git synced 2026-11-09 17:41:56 -10:00
Code Issues Packages Projects Releases Wiki Activity
Files
codex/https-setup-guide
paperclip-docs/site/redirects.json
T
DottaandDevRel Gemini 1f6b9f3846 docs: redirect legacy what-is-paperclip URL (#93) 
## Thinking Path

> - Paperclip uses a public documentation site to help users learn the
product.
> - The site build reads legacy routes from `site/redirects.json`.
> - Two old `/start/` routes redirect to current guide pages.
> - The old `/start/what-is-paperclip` route has no matching redirect.
> - Search engines still send users to that old route.
> - This pull request adds the missing redirect entry.
> - The benefit is a working 301 response for both slash variants.

## Linked Issues or Issue Description

**Issue type**

Outdated documentation route.

**Where is the issue?**

`https://docs.paperclip.ing/start/what-is-paperclip`

**What's wrong?**

The legacy URL returns a hard 404. The live replacement is
`/guides/welcome/what-is-paperclip/`.

**Suggested fix**

Add the proven legacy path to `site/redirects.json`. Do not add
speculative `/start/` redirects.

## What Changed

- Added `start/what-is-paperclip` to the legacy redirect map.
- Kept the existing `start/quickstart` and `start/core-concepts`
mappings unchanged.

## Verification

- Ran `npm run docs:test:static-routes` successfully.
- Ran `npm run docs:build` successfully.
- Confirmed the generated `_redirects` file contains 301 rules for both
`/start/what-is-paperclip` variants.
- Confirmed the generated sibling rules remain present.

## Risks

- Low risk. The change adds one redirect map entry and does not change
page content or route generation logic.

## Model Used

- OpenAI `gpt-5.4` through Codex CLI, with reasoning, tool use, and code
execution. The runtime does not expose the context window size.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change and contains no internal
ticket ID
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] All configured CI gates are green
- [x] No Greptile check is configured for this repository, and no
Greptile comments are open
- [x] I will address all Greptile and reviewer comments before
requesting merge

Co-authored-by: DevRel Gemini <[email protected]>
2026-08-13 10:09:01 -04:00

96 lines
5.7 KiB
JSON
Raw Permalink Blame History

{
"user-guides/guides/what-is-paperclip": "guides/welcome/what-is-paperclip",
"user-guides/guides/key-concepts": "guides/welcome/key-concepts",
"user-guides/guides/glossary": "guides/welcome/glossary",
"user-guides/guides/installation": "guides/getting-started/installation",
"user-guides/guides/your-first-company": "guides/getting-started/your-first-company",
"user-guides/guides/your-first-agent": "guides/getting-started/your-first-agent",
"user-guides/guides/watching-agents-work": "guides/getting-started/watching-agents-work",
"user-guides/guides/dashboard": "guides/day-to-day/dashboard",
"user-guides/guides/managing-tasks": "guides/day-to-day/issues",
"guides/day-to-day/managing-tasks": "guides/day-to-day/issues",
"user-guides/guides/approvals": "guides/day-to-day/approvals",
"user-guides/guides/costs-and-budgets": "guides/day-to-day/costs",
"guides/day-to-day/costs-and-budgets": "guides/day-to-day/costs",
"user-guides/guides/activity-log": "guides/day-to-day/activity-log",
"user-guides/guides/feedback-voting": "guides/day-to-day/feedback-voting",
"guides/board-operator/dashboard": "guides/day-to-day/dashboard",
"guides/board-operator/managing-tasks": "guides/day-to-day/issues",
"guides/board-operator/managing-agents": "guides/org/agents",
"guides/board-operator/org-structure": "guides/org/org-structure",
"guides/board-operator/creating-a-company": "guides/getting-started/your-first-company",
"guides/agent-developer/how-agents-work": "guides/org/agents",
"guides/agent-developer/comments-and-communication": "guides/day-to-day/issues",
"guides/agent-developer/task-workflow": "guides/day-to-day/issues",
"guides/agent-developer/handling-approvals": "guides/day-to-day/approvals",
"guides/agent-developer/cost-reporting": "guides/day-to-day/costs",
"user-guides/guides/skills": "guides/org/skills",
"user-guides/guides/org-structure": "guides/org/org-structure",
"user-guides/guides/delegation": "guides/org/delegation",
"user-guides/guides/agent-adapters": "guides/org/agent-adapters",
"user-guides/guides/heartbeats-and-routines": "guides/projects-workflow/routines",
"guides/projects-workflow/heartbeats-and-routines": "guides/projects-workflow/routines",
"user-guides/guides/execution-workspaces": "guides/projects-workflow/workspaces",
"guides/projects-workflow/execution-workspaces": "guides/projects-workflow/workspaces",
"user-guides/guides/execution-policy": "guides/power/execution-policy",
"user-guides/guides/export-import": "guides/power/export-import",
"user-guides/guides/terminal-setup": "guides/power/terminal-setup",
"user-guides/guides/administration/company": "administration/company",
"user-guides/guides/administration/settings": "administration/settings",
"user-guides/guides/administration/plugins": "administration/plugins",
"start/quickstart": "guides/getting-started/five-minute-path",
"start/core-concepts": "guides/welcome/key-concepts",
"start/what-is-paperclip": "guides/welcome/what-is-paperclip",
"tutorials": "guides/getting-started/five-minute-path",
"how-to": "how-to/enable-multi-user-login",
"glossary": "guides/welcome/glossary",
"reference": "reference/api/overview",
"explanation": "guides/welcome/what-is-paperclip",
"api/overview": "reference/api/overview",
"api/authentication": "reference/api/authentication",
"api/companies": "reference/api/companies",
"api/agents": "reference/api/agents",
"api/issues": "reference/api/issues",
"api/approvals": "reference/api/approvals",
"api/goals-and-projects": "reference/api/goals-and-projects",
"api/costs": "reference/api/costs",
"api/secrets": "reference/api/secrets",
"api/activity": "reference/api/activity",
"api/dashboard": "reference/api/dashboard",
"api/routines": "reference/api/routines",
"cli/overview": "reference/cli/overview",
"cli/setup-commands": "reference/cli/setup-commands",
"cli/control-plane-commands": "reference/cli/overview",
"adapters/overview": "reference/adapters/overview",
"adapters/claude-local": "reference/adapters/claude-code",
"adapters/codex-local": "reference/adapters/codex",
"adapters/gemini-local": "reference/adapters/gemini-cli",
"adapters/cursor-local": "reference/adapters/cursor-local",
"adapters/opencode-local": "reference/adapters/opencode",
"adapters/pi-local": "reference/adapters/pi",
"adapters/hermes-local": "reference/adapters/hermes",
"adapters/openclaw-gateway": "reference/adapters/openclaw-gateway",
"adapters/process": "reference/adapters/process",
"adapters/http": "reference/adapters/http",
"adapters/external-adapters": "reference/adapters/external-adapters",
"adapters/creating-an-adapter": "reference/adapters/creating-an-adapter",
"adapters/adapter-ui-parser": "reference/adapters/adapter-ui-parser",
"deploy/overview": "reference/deploy/overview",
"deploy/deployment-modes": "reference/deploy/deployment-modes",
"deploy/local-development": "reference/deploy/local-development",
"deploy/docker": "reference/deploy/docker",
"deploy/database": "reference/deploy/database",
"deploy/storage": "reference/deploy/storage",
"deploy/secrets": "reference/deploy/secrets",
"deploy/environment-variables": "reference/deploy/environment-variables",
"deploy/tailscale-private-access": "reference/deploy/tailscale-private-access",
"reference/cli/commands": "reference/cli/overview",
"reference/cli/control-plane-commands": "reference/cli/overview",
"reference/adapters/claude-local": "reference/adapters/claude-code",
"reference/adapters/codex-local": "reference/adapters/codex",
"reference/adapters/gemini-local": "reference/adapters/gemini-cli",
"reference/adapters/opencode-local": "reference/adapters/opencode",
"reference/adapters/pi-local": "reference/adapters/pi",
"reference/adapters/hermes-local": "reference/adapters/hermes"
}
Reference in new issue View Git Blame Copy Permalink