Skip to content

docs: add 18 ESLint-style rule example pages - #90

Merged
rhuanbarreto merged 4 commits into
mainfrom
worktree-zesty-shimmying-rabin
Mar 19, 2026
Merged

docs: add 18 ESLint-style rule example pages#90
rhuanbarreto merged 4 commits into
mainfrom
worktree-zesty-shimmying-rabin

Conversation

@rhuanbarreto

Copy link
Copy Markdown
Contributor

Summary

  • Restructured rule examples documentation: separated inline examples from the Writing Rules guide into dedicated pages
  • Converted common-rule-patterns.mdx into a categorized index page linking to 18 individual rule pages
  • Each rule page follows an ESLint-inspired format: rule details, incorrect/correct code, full .rules.ts implementation, when to use it, when not to use it
  • All pages created in both EN and PT-BR (36 new files)
  • Used Starlight autogenerate for the Examples sidebar section
  • Real-world examples sourced from archgate, money-sync, and stavanger-challenge repositories

Rule pages by category

Category Rules
Dependency & Packages no-unapproved-deps, version-catalog, monorepo-task-runner
Import & API Restrictions no-banned-imports, no-banned-api, wrapper-enforcement
File Structure kebab-case-filenames, no-barrel-files, test-file-coverage, component-pairing
Code Quality no-todo-comments, no-emoji-in-output, max-file-length, page-component-constraints
Database Schema database-audit-fields
Architecture Boundaries required-export-pattern, openapi-routes, clean-architecture-layers

Test plan

  • bun run validate passes (lint, typecheck, format, tests, ADR check, build)
  • docs site builds successfully (73 pages indexed)
  • Review individual rule pages for accuracy and completeness
  • Verify sidebar navigation works correctly with autogenerate

rhuanbarreto and others added 3 commits March 19, 2026 15:08
CLAUDE.md: replace command table, ADR list, and pinned versions with
references to src/commands/, .archgate/adrs/, and .prototools.
README.md: remove commands table and CI section, defer to docs site.
Homepage (en + pt-br): replace "Six ADRs" with open-ended text and
link to the ADRs directory on GitHub.
Restructure the rule examples documentation:

- Split inline examples out of writing-rules.mdx into dedicated pages
- Convert common-rule-patterns.mdx into a categorized index page
- Add 18 individual rule pages (EN + PT-BR = 36 files) covering:
  dependency management, import restrictions, file structure,
  code quality, database schema, and architecture boundaries
- Each page follows ESLint-style format: rule details, incorrect/correct
  code examples, full .rules.ts implementation, when to use/not use
- Use Starlight autogenerate for the Examples sidebar section
- Real-world examples sourced from archgate, money-sync, and
  stavanger-challenge repositories
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Mar 19, 2026

Copy link
Copy Markdown

Deploying archgate-cli with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7c9e32b
Status:⚡️  Build in progress...

View logs

@rhuanbarreto
rhuanbarreto merged commit 647726b into main Mar 19, 2026
8 of 9 checks passed
@rhuanbarreto
rhuanbarreto deleted the worktree-zesty-shimmying-rabin branch March 19, 2026 14:46
rhuanbarreto added a commit that referenced this pull request Mar 20, 2026
* docs: remove hardcoded versions and counts, point to source files

CLAUDE.md: replace command table, ADR list, and pinned versions with
references to src/commands/, .archgate/adrs/, and .prototools.
README.md: remove commands table and CI section, defer to docs site.
Homepage (en + pt-br): replace "Six ADRs" with open-ended text and
link to the ADRs directory on GitHub.

* docs: add 18 individual ESLint-style rule example pages

Restructure the rule examples documentation:

- Split inline examples out of writing-rules.mdx into dedicated pages
- Convert common-rule-patterns.mdx into a categorized index page
- Add 18 individual rule pages (EN + PT-BR = 36 files) covering:
  dependency management, import restrictions, file structure,
  code quality, database schema, and architecture boundaries
- Each page follows ESLint-style format: rule details, incorrect/correct
  code examples, full .rules.ts implementation, when to use/not use
- Use Starlight autogenerate for the Examples sidebar section
- Real-world examples sourced from archgate, money-sync, and
  stavanger-challenge repositories

* docs: regenerate llms-full.txt
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