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

docs: configure spell check, minor improvements #5369

Merged
merged 14 commits into from
Dec 19, 2023
Merged

Conversation

sarahschwartz
Copy link
Contributor

@sarahschwartz sarahschwartz commented Dec 5, 2023

This PR configures the spell-check added to the docs workflow in the github-actions repo: FuelLabs/github-actions#23

The files checked are configured in .spellcheck.yml. This is also where you can configure what types of elements are ignored.

Right now it ignores:

  • All code blocks that have a language (and will check code blocks that do not have a language)
  • Anything in between backticks
  • Words in spell-check-custom-words.txt (case sensitive, only exact match)
  • Numbers, even if they are attached to a word
  • Links in markdown link format

Handling errors:

If the test fails:

  • look up the word in the question to verify it is a real word and is correctly spelled
  • If it is a file name or is code, use backticks to ignore the word.
  • If it is a real word that is spelled correctly, or an acronym that is either common or is defined already, add it to spell-check-custom-words.txt.
  • If needed, rewrite the sentence. Ex: DON'T use "locking" and add "ing" to the custom words list. Instead, rewrite the sentence as "locking with the lock method".
  • If it otherwise should be ignored, you can configure the pipeline in .spellcheck.yml.

@sarahschwartz sarahschwartz self-assigned this Dec 5, 2023
@sarahschwartz sarahschwartz changed the title docs: add spell check, minor improvements docs: configure spell check, minor improvements Dec 7, 2023
sarahschwartz added a commit to FuelLabs/github-actions that referenced this pull request Dec 7, 2023
This PR adds a spell-check to each docs workflow. You can see it tested
here:

Sway: FuelLabs/sway#5369
Fuelup: FuelLabs/fuelup#535
Specs: FuelLabs/fuel-specs#539
Fuels-rs: FuelLabs/fuels-rs#1224
Fuels-ts: FuelLabs/fuels-ts#1484
Wallet: FuelLabs/fuels-wallet#987
Indexer: FuelLabs/fuel-indexer#1496
GraphQL: FuelLabs/fuel-graphql-docs#25
@sarahschwartz sarahschwartz marked this pull request as ready for review December 7, 2023 21:47
Copy link
Member

@sdankel sdankel left a comment

Choose a reason for hiding this comment

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

Looks good, just have a few questions/nits

docs/book/src/SUMMARY.md Show resolved Hide resolved
docs/book/src/basics/methods_and_associated_functions.md Outdated Show resolved Hide resolved
docs/book/src/examples/fizzbuzz.md Show resolved Hide resolved
docs/book/spell-check-custom-words.txt Show resolved Hide resolved
docs/book/.spellcheck.yml Show resolved Hide resolved
sdankel
sdankel previously approved these changes Dec 13, 2023
@sdankel
Copy link
Member

sdankel commented Dec 15, 2023

There are conflicts with master now @sarahschwartz

sdankel
sdankel previously approved these changes Dec 19, 2023
@sarahschwartz sarahschwartz merged commit fe65ca4 into master Dec 19, 2023
33 checks passed
@sarahschwartz sarahschwartz deleted the sarah/spell-check branch December 19, 2023 23:10
@JoshuaBatty JoshuaBatty mentioned this pull request Aug 19, 2024
8 tasks
JoshuaBatty added a commit that referenced this pull request Aug 19, 2024
## Description
I noticed that the command section for forc in the documentation was
only showing headings and no information about the commands themselves.
See below.

![Screenshot 2024-08-19 at 10 47
48 AM](https://github.com/user-attachments/assets/ee5c00d3-97f2-445a-b1c7-203144bf2d13)

This was due to back ticks being placed around the heading in #5369.
I've removed these ticks and added the commands to the list of accepted
words.

Also there were a lot of commands being missed due to their no longer
being subcommands, this logic has been updated and all the forc commands
are now being parsed.

## Checklist

- [x] I have linked to any relevant issues.
- [x] I have commented my code, particularly in hard-to-understand
areas.
- [x] I have updated the documentation where relevant (API docs, the
reference, and the Sway book).
- [x] If my change requires substantial documentation changes, I have
[requested support from the DevRel
team](https://github.com/FuelLabs/devrel-requests/issues/new/choose)
- [x] I have added tests that prove my fix is effective or that my
feature works.
- [x] I have added (or requested a maintainer to add) the necessary
`Breaking*` or `New Feature` labels where relevant.
- [x] I have done my best to ensure that my PR adheres to [the Fuel Labs
Code Review
Standards](https://github.com/FuelLabs/rfcs/blob/master/text/code-standards/external-contributors.md).
- [x] I have requested a review from the relevant team or maintainers.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants