Skip to content

docs: add file organization conventions - #249

Open
angeloashmore wants to merge 2 commits into
mainfrom
docs/file-organization-conventions
Open

docs: add file organization conventions#249
angeloashmore wants to merge 2 commits into
mainfrom
docs/file-organization-conventions

Conversation

@angeloashmore

Copy link
Copy Markdown
Member

Resolves:

Description

Writes down the repository's file organization conventions in a new AGENTS.md so agents and developers can follow them, and aligns existing code with those conventions:

  • The docs client no longer reads the app's env object; it hardcodes the docs host with an override option, and callers pass PRISMIC_DOCS_HOST through.
  • completeOnboardingStepsSilently is removed from the repository client; callers use an inline .catch() instead.

Checklist

  • A comprehensive Linear ticket, providing sufficient context and details to facilitate the review of the PR, is linked to the PR.
  • If my changes require tests, I added them.
  • If my changes affect backward compatibility, it has been discussed.
  • If my changes require an update to the CONTRIBUTING.md guide, I updated it.

Preview

How to QA 1

Run node --run build, then ./dist/index.mjs docs list to confirm the docs commands still reach the live docs host.

🤖 Generated with Claude Code

Footnotes

  1. Please use these labels when submitting a review:
    ❓ #ask: Ask a question.
    💡 #idea: Suggest an idea.
    ⚠️ #issue: Strongly suggest a change.
    🎉 #nice: Share a compliment.

angeloashmore and others added 2 commits July 31, 2026 19:44
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Remove the env import from the docs client by hardcoding the docs host
with an override option, and replace completeOnboardingStepsSilently
with an inline catch at its call sites.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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