Skip to content

ENG-2009 update llm docs authoring guidance for nextra docs tree#1210

Merged
mdroidian merged 4 commits into
mainfrom
eng-2009-update-llm-docs-authoring-guidance-for-nextra-docs-tree
Jul 9, 2026
Merged

ENG-2009 update llm docs authoring guidance for nextra docs tree#1210
mdroidian merged 4 commits into
mainfrom
eng-2009-update-llm-docs-authoring-guidance-for-nextra-docs-tree

Conversation

@mdroidian

@mdroidian mdroidian commented Jul 8, 2026

Copy link
Copy Markdown
Member

…LL.md, and related references

- Added sections for plugin documentation locations and sidebar order management in CONTRIBUTING.md.
- Enhanced SKILL.md with guardrails for editing live docs and clarified steps for determining documentation needs.
- Updated doc-conventions.md to specify file locations and naming conventions for user-facing plugin docs.
- Revised navigation-mapping.md to reflect new content structure and sidebar registration processes.
- Improved scope-detection.md with detailed mapping for file paths to documentation scope and clarified when to update docs for both platforms.
@linear-code

linear-code Bot commented Jul 8, 2026

Copy link
Copy Markdown

ENG-2009

@vercel

vercel Bot commented Jul 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
discourse-graph Ready Ready Preview, Comment Jul 9, 2026 12:35am

Request Review

@supabase

supabase Bot commented Jul 8, 2026

Copy link
Copy Markdown

This pull request has been ignored for the connected project zytfjzqyijgagqxrzbmz because there are no changes detected in packages/database/supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

… SKILL.md, and related references

- Added instructions to utilize existing Nextra Markdown, MDX, and components for styling and layout before proposing custom solutions.
- Clarified that changes to theme, layout, route, component, or CSS should not be included in content-only documentation updates.
- Emphasized the need to create separate Linear tickets for any required Nextra functionality not currently supported.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment thread skills/update-user-docs/references/doc-conventions.md Outdated
Comment thread skills/update-user-docs/references/navigation-mapping.md
@mdroidian

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Chef's kiss.

Reviewed commit: bb687aa5a9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@mdroidian mdroidian merged commit bb2dad9 into main Jul 9, 2026
6 of 7 checks passed
@mdroidian mdroidian deleted the eng-2009-update-llm-docs-authoring-guidance-for-nextra-docs-tree branch July 9, 2026 00:35
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