Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add natural language linting #335

Merged
merged 10 commits into from
Jul 24, 2024
Merged

Conversation

dshevtsov
Copy link
Contributor

@dshevtsov dshevtsov commented Jul 12, 2024

Purpose of this pull request

This pull request (PR) changes the PR testing workflow by enabling textlint which is a natural language linter. By default, the linter only verifies terminology. The level of severity is set to warning so that it would not fail the entire GitHub check. The code base was checked with the linter and edited with the tool's local option for auto-fixing.

Also, the single job in the GitHub workflow validate is separated into two for clarity and flexibility: lint and test_and_build.

To view the textlint warnings, open the check's log: lint - Lint Code Base - NATURAL_LANGUAGE (example).

To run the linting locally: npx textlint .
To run auto-fixing locally: npx textlint --fix .

@dshevtsov dshevtsov added enhancement New feature or request editorial Typo and grammar fixes or minor rewrites to correct inaccuracies labels Jul 12, 2024
@dshevtsov dshevtsov self-assigned this Jul 12, 2024
@dshevtsov dshevtsov marked this pull request as ready for review July 12, 2024 21:26
README.md Outdated Show resolved Hide resolved
src/pages/graphql/schema/products/queries/products.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
.github/linters/.textlintrc Outdated Show resolved Hide resolved
Co-authored-by: Jared Hoover <[email protected]>
Co-authored-by: Kevin Harper <[email protected]>
@dshevtsov dshevtsov requested a review from jhadobe July 15, 2024 15:17
@dshevtsov dshevtsov closed this Jul 24, 2024
@dshevtsov
Copy link
Contributor Author

Closing the PR because there is no consensus on the final list of terminology that should be enforced by the linter.

@dshevtsov dshevtsov reopened this Jul 24, 2024
@dshevtsov
Copy link
Contributor Author

Reopening per request from the project owner

Copy link
Contributor Author

@dshevtsov dshevtsov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reverting the frontend/backend terms

src/_includes/graphql/attribute-metadata.md Outdated Show resolved Hide resolved
src/pages/get-started/gs-web-api-request.md Outdated Show resolved Hide resolved
src/pages/get-started/index.md Outdated Show resolved Hide resolved
src/pages/graphql/usage/index.md Outdated Show resolved Hide resolved
src/pages/index.md Outdated Show resolved Hide resolved
src/pages/rest/use-rest/search-endpoint.md Outdated Show resolved Hide resolved
src/pages/rest/use-rest/search-endpoint.md Outdated Show resolved Hide resolved
@dshevtsov dshevtsov requested a review from keharper July 24, 2024 17:37
@dshevtsov
Copy link
Contributor Author

dshevtsov commented Jul 24, 2024

@jhadobe please update your review since it's blocking the PR merging.

@dshevtsov dshevtsov merged commit e9fc035 into AdobeDocs:main Jul 24, 2024
3 checks passed
@dshevtsov dshevtsov deleted the ds_textlint branch July 24, 2024 19:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial Typo and grammar fixes or minor rewrites to correct inaccuracies enhancement New feature or request
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

3 participants