Mirror PR #3169 changes to inki/references/ for agents/ files migrated by Inki

Author: pwizla

claude-plugins/inki/references/authoring/AGENTS.cms.features.md

@@ -54,6 +54,10 @@ Heading Conventions
 - Use H2 for major sections (Configuration, Usage); H3 for subsections.
 - Keep headings action‑oriented and specific (e.g., “Admin panel configuration”, not “Configuration details”).
 
+Sidebar
+- Feature pages use flat `type: 'doc'` entries in `sidebars.js`. Never create, replace, or convert them to `type: 'category'` entries.
+- If a feature has sub-pages (e.g., API references), link to them from the page content using `<CustomDocCardsWrapper>` and `<CustomDocCard>` components — not via sidebar nesting.
+
 Cross‑linking
 - Link to related features (e.g., Content‑type Builder, Content Manager) and relevant API references.
 - Prefer relative links within `/cms/` and use the consistent link text used across docs.

claude-plugins/inki/references/prompts/style-checker.md

@@ -191,13 +191,14 @@ Beyond the 12 rules, also check for:
 - **Severity:** warning
 - **Note:** Strapi documentation always uses absolute-style paths starting with `/`. The `./` relative prefix should not appear in documentation prose or code examples referencing project file paths.
 
-### Em dashes
-- **Detect:** Em dashes (—) anywhere in prose
+### Em dashes and double hyphens
+- **Detect:** Em dashes (—) and double hyphens used as dashes ( -- ) anywhere in prose
 - **Severity:** error
-- **Note:** Em dashes are not used in Strapi technical documentation. They are a common signal of AI-generated text. Replace with a colon, a period, or restructure the sentence.
+- **Note:** Neither em dashes nor double hyphens are used as dashes in Strapi technical documentation. They are a common signal of AI-generated text. Replace with a colon, a period, parentheses, or restructure the sentence.
   - `"Status — shows the current state"` → `"Status: shows the current state"`
   - `"The button — visible only to admins — opens the panel"` → `"The button opens the panel. It is only visible to admins."`
-- **Exception:** Em dashes inside HTML comments (`<!-- ... -->`) and inside hyperlink text that references an external page title should NOT be flagged.
+  - `"the token -- received by email"` → `"the token (received by email)"`
+- **Exception:** Em dashes and double hyphens inside HTML comments (`<!-- ... -->`), code fences, and inside hyperlink text that references an external page title should NOT be flagged.
 
 ### Consistency
 - **Detect:** Inconsistent terminology within the same document (e.g., "admin panel" vs "Admin Panel" vs "administration panel"); inconsistent heading capitalization