Documentation updates not visible on live docs site #3906

Closed
opened 2026-02-16 17:41:53 -05:00 by yindo · 3 comments
Owner

Originally created by @connorads on GitHub (Dec 27, 2025).

Originally assigned to: @jayair on GitHub.

PR #6132 was merged but the changes are not visible on either the production or dev docs sites.

Expected: Both sites should show ~/.config/opencode/skill/ instead of ~/.opencode/skill/

Image

Closes #6171

📋 OpenCode research findings (not validated)

Deployment Status

Dev deployments: ✓ Working

  • Latest deploy: Dec 27, 06:51 UTC - SUCCESS
  • Deployed commit: `4667d57e3`
  • Git contains correct content: `~/.config/opencode/skill/`

Production deployments: Blocked

Potential Root Cause: Cloudflare Cache

Even with aggressive cache-busting headers, Cloudflare edge returns HIT status:
```
$ curl -I https://dev.opencode.ai/docs/skills/
cf-cache-status: HIT
cache-control: public, max-age=0, must-revalidate

$ curl -s -H "Cache-Control: no-cache" https://dev.opencode.ai/docs/skills/ | grep "~/."
~/.opencode/skill # Old content, not the deployed version
```

This suggests the deployed content is correct, but Cloudflare is serving stale cached versions.

Possible fixes (not tested):

  1. Purge Cloudflare cache for `/docs/*` paths
  2. Run `bun sst unlock --stage=production` for production
  3. Review cache headers in Astro config
Originally created by @connorads on GitHub (Dec 27, 2025). Originally assigned to: @jayair on GitHub. PR #6132 was merged but the changes are not visible on either the production or dev docs sites. - **Production docs**: https://opencode.ai/docs/skills/ (still shows `~/.opencode/skill/`) - **Dev docs**: https://dev.opencode.ai/docs/skills/ (still shows `~/.opencode/skill/`) Expected: Both sites should show `~/.config/opencode/skill/` instead of `~/.opencode/skill/` <img width="897" height="244" alt="Image" src="https://github.com/user-attachments/assets/aa643a5e-c895-4bb3-9b27-c2ae3dbd8190" /> Closes #6171 <details> <summary>📋 OpenCode research findings (not validated)</summary> ### Deployment Status **Dev deployments**: ✓ Working - Latest deploy: [Dec 27, 06:51 UTC](https://github.com/sst/opencode/actions/runs/20535718721) - SUCCESS - Deployed commit: \`4667d57e3\` - Git contains correct content: \`~/.config/opencode/skill/\` **Production deployments**: ❌ Blocked - Failing since Dec 24 with: \`Locked: A concurrent update was detected on the app. Run \`sst unlock\` to remove the lock\` - [Latest failed (Dec 26)](https://github.com/sst/opencode/actions/runs/20529171898) - [Last successful (Dec 24)](https://github.com/sst/opencode/actions/runs/20490230489/job/58888165286) ### Potential Root Cause: Cloudflare Cache Even with aggressive cache-busting headers, Cloudflare edge returns HIT status: \`\`\` $ curl -I https://dev.opencode.ai/docs/skills/ cf-cache-status: HIT cache-control: public, max-age=0, must-revalidate $ curl -s -H "Cache-Control: no-cache" https://dev.opencode.ai/docs/skills/ | grep "~/." ~/.opencode/skill # Old content, not the deployed version \`\`\` This suggests the deployed content is correct, but Cloudflare is serving stale cached versions. **Possible fixes (not tested):** 1. Purge Cloudflare cache for \`/docs/*\` paths 2. Run \`bun sst unlock --stage=production\` for production 3. Review cache headers in Astro config </details>
yindo added the docs label 2026-02-16 17:41:53 -05:00
yindo closed this issue 2026-02-16 17:41:53 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Dec 27, 2025):

This issue might be a duplicate of existing issues. Please check:

  • #6171: Inconsistency in docs for where to install skills

This issue (#6241) appears to be related to the deployment of PR #6132 which was meant to address the exact documentation inconsistency mentioned in #6171. Both issues concern the same documentation path update from ~/.opencode/skill/ to ~/.config/opencode/skill/.

Feel free to ignore if this doesn't address your specific case.

@github-actions[bot] commented on GitHub (Dec 27, 2025): This issue might be a duplicate of existing issues. Please check: - #6171: Inconsistency in docs for where to install skills This issue (#6241) appears to be related to the deployment of PR #6132 which was meant to address the exact documentation inconsistency mentioned in #6171. Both issues concern the same documentation path update from `~/.opencode/skill/` to `~/.config/opencode/skill/`. Feel free to ignore if this doesn't address your specific case.
Author
Owner

@connorads commented on GitHub (Dec 27, 2025):

We can close #6171 when this is fixed I think

@connorads commented on GitHub (Dec 27, 2025): We can close #6171 when this is fixed I think
Author
Owner

@rekram1-node commented on GitHub (Dec 27, 2025):

i just havent deployed the docs ill do that today

@rekram1-node commented on GitHub (Dec 27, 2025): i just havent deployed the docs ill do that today
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3906