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

Fix spelling in Operator docs and related protos #46876

Closed

Conversation

ptgott
Copy link
Contributor

@ptgott ptgott commented Sep 23, 2024

Related to #46191

Help us move to a new, more scalable spell checker based on vale by supporting spell checking in the Operator resource reference. While vale cannot ignore specific files (unless we run the CLI on all but those files), it is possible to fine-tune a vale spell-check rule so we can check the Operator resource reference docs:

  • Fix specific spelling errors in some of our proto files.
  • Use "Boolean" instead of "boolean" in Operator resource reference docs by substituting the incorrect spelling in the docs generator.
  • Wrap field type names and headings in backticks to avoid the vale spell checker. The vale spell checker ignores all content in backticks.

Related to #46191

Help us move to a new, more scalable spell checker based on vale by
supporting spell checking in the Operator resource reference. While vale
cannot ignore specific files (unless we run the CLI on all _but_ those
files), it is possible to fine-tune a vale spell-check rule so we can
check the Operator resource reference docs:

- Fix specific spelling errors in some of our proto files.
- Use "Boolean" instead of "boolean" in Operator resource reference docs
  by substituting the incorrect spelling in the docs generator.
- Wrap field type names and headings in backticks to avoid the vale
  spell checker. The vale spell checker ignores all content in
  backticks.
Copy link

🤖 Vercel preview here: https://docs-d91t7jxg1-goteleport.vercel.app/docs/ver/preview

@hugoShaka
Copy link
Contributor

I think you'll need to re-render the TF resources and docs as well with make -C integrations/terraform gen-tfschema docs

@@ -82,8 +82,8 @@ message AccessListOwner {
// owner.
string description = 2;

// ineligible_status describes if this owner is eligible or not
// and if not, describes how they're lacking eligibility.
// describes if this owner is eligible or not and if not, describes how
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
// describes if this owner is eligible or not and if not, describes how
// `ineligible_status` describes if this owner is eligible or not and if not, describes how

It looks like we're removing the field name in some of these changes. Is this intentional?

@ptgott
Copy link
Contributor Author

ptgott commented Oct 25, 2024

This PR has been sitting around for a while, so I am going to close it in favor of ignoring the Vale spellchecker in our auto-generated references to avoid making the first iteration of this project too large.

@ptgott ptgott closed this Oct 25, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport/branch/v16 documentation no-changelog Indicates that a PR does not require a changelog entry size/sm
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants