Skip to content

docs: add incompatibleWith authoring rules (fixes #119) - #190

Merged
ulises-jeremias merged 1 commit into
mainfrom
docs/incompatiblewith-authoring-119
Aug 24, 2026
Merged

docs: add incompatibleWith authoring rules (fixes #119)#190
ulises-jeremias merged 1 commit into
mainfrom
docs/incompatiblewith-authoring-119

Conversation

@ulises-jeremias

Copy link
Copy Markdown
Member

Closes #119

Adds contributor-facing incompatibleWith — when and how recipe to docs/AUTHORING.md:

  • When to use: extensions that write the same file (Dockerfile, compose.yml, .env.example, pyproject.toml overlay) for the same type (e.g. celery-docker vs flower-docker both for celery-worker)
  • Must be symmetric: if A lists B, B must list A (validated by scripts/ci/validate-registry.py)
  • Type restriction: only for same type
  • Example JSON snippet with symmetric slugs
  • Validation: python scripts/ci/validate-registry.py checks symmetry and existence
  • Testing: L2 fails if both selected together
  • Links scripts/ci/validate-registry.py and templates.schema.json

Keeps subsection under 30 lines, contributor-focused.

Related to #91.

Validation: python scripts/ci/validate-registry.py → ✅ registry ok (6 templates, 19 extensions)

Closes #119. Documents incompatibleWith contributor recipe: when to use
(same file/type — Dockerfile, compose.yml, .env.example, pyproject.toml
overlay e.g. celery-docker vs flower-docker for celery-worker), symmetric
requirement, same-type restriction, example JSON, validation via
scripts/ci/validate-registry.py and templates.schema.json, L2 failure on
combination. Related to #91.
@ulises-jeremias
ulises-jeremias marked this pull request as ready for review August 24, 2026 05:05
@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 6 minutes.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 0b01a21a-af54-4a22-a5f1-53923750c7cd

📥 Commits

Reviewing files that changed from the base of the PR and between 1c20aae and 14e7eb2.

📒 Files selected for processing (1)
  • docs/AUTHORING.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ulises-jeremias
ulises-jeremias merged commit f575ee4 into main Aug 24, 2026
13 checks passed
@ulises-jeremias
ulises-jeremias deleted the docs/incompatiblewith-authoring-119 branch August 24, 2026 05:07
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.

docs: document incompatibleWith authoring rules in AUTHORING.md

1 participant