-
Notifications
You must be signed in to change notification settings - Fork 27.1k
Description
Description
When the guide content of angular.io is analyzed by the documentation lint tool, ~3/4 of the topic files in the guide directory contain lint errors that should be corrected as soon as practical.
Removing the lint errors from the documentation helps improve the documentation's readability by correcting the current content. After the documentation topics are free of linting errors, we can incorporate documentation linting into the CI/CD process to maintain clean documentation content going forward.
Note that PRs for fixes related to this issue do not need to include every topic with a lint error. PRs for individual or several files are preferred.
How to help
- Review Contributing to Angular
- Install the documentation linter on your local development system and IDE
- Make sure you can build the angular.io site on your development system
- Find and fix a topic (repeat as often as you'd like)
- Open a topic from angular/angular/aio/content/guide
- Review the commit message format to use when committing your changes
- Review and correct the problems identified by the documentation linter
- Save and commit your updated topic.
- Submit a PR with your revisions
What is the affected URL?
many
Please provide the steps to reproduce the issue
With the documentation linter installed in an IDE, open a guide topic and notice the problems that the linter identifies.
Please provide the expected behavior vs the actual behavior you encountered
The documentation source code should not have any documentation linter errors, and ideally, it should not have any problems at all.
Please provide a screenshot if possible
N/A
Please provide the exception or error you saw
N/A
Is this a browser-specific issue? If so, please specify the device, browser, and version.
Not browser specific.