@readme/spectral-config
v5.0.6
Published
ReadMe coding standards for API documentation
Downloads
1,328
Maintainers
Keywords
Readme
@readme/spectral-config
ReadMe coding standards for API documentation, using Spectral linting rules.
Installation
npm install --save @readme/spectral-config
Usage
Create a .spectral.yml
file with the following contents:
extends: '@readme/spectral-config'
Rules
Note
This ruleset extends the core
oas
ruleset in Spectral. All of these rules are enabled by default.
| Rule | Description |
| :--- | :--- |
| alex-component-summary
| Component schema summaries should have inclusive and considerate language. |
| alex-component-descriptions
| Component schema description should have inclusive and considerate language. |
| alex-operation-summary
| Operation summaries should have inclusive and considerate language. |
| alex-operation-description
| Operation descriptions should have inclusive and considerate language.|
| alex-parameter
| Operation parameters should have inclusive and considerate language. |
| alex-response
| Operation responses should have inclusive and considerate language. |
| description-sentence-punctuation
| Descriptions should have ending punctuation. |