The documentation alternates between “rule” and “convention” for the same Konsistent concept, while predicates are the actual individual checks inside a convention. This makes the policy hierarchy harder to understand and should use “convention” consistently.
Relevant files:
packages/konsistent/README.mddocs/README.mddocs/reference/configuration.mddocs/reference/conditional-rules.mddocs/guides/getting-started.md
Replace “rule” with “convention” wherever the full scoped policy is meant, including headings, filenames, links, examples, and internal identifiers that encode the documentation term. Keep “predicate” for an individual assertion.
Backward compatibility: documentation and internal terminology can be renamed or removed without compatibility shims. No konsistent.json schema change is expected; if one becomes necessary, retain the old name and behavior as deprecated and emit a non-failing CLI warning when it is used.
The documentation alternates between “rule” and “convention” for the same Konsistent concept, while predicates are the actual individual checks inside a convention. This makes the policy hierarchy harder to understand and should use “convention” consistently.
Relevant files:
packages/konsistent/README.mddocs/README.mddocs/reference/configuration.mddocs/reference/conditional-rules.mddocs/guides/getting-started.mdReplace “rule” with “convention” wherever the full scoped policy is meant, including headings, filenames, links, examples, and internal identifiers that encode the documentation term. Keep “predicate” for an individual assertion.
Backward compatibility: documentation and internal terminology can be renamed or removed without compatibility shims. No
konsistent.jsonschema change is expected; if one becomes necessary, retain the old name and behavior as deprecated and emit a non-failing CLI warning when it is used.