Comments (8)
As a maintainer and avid grammarian, I would love if the spell check could check the description
field of links.json
.
This snippet would extract them when executed in a track's repository:
find . -name 'links.json' | xargs jq '.[] | .description'
from docs.
@SaschaMann This is a good target for an org-wide check.
from docs.
Great idea @wolf99! There is a plugin retext-spell that uses Hunspell I think. I've seen other OSS teams leverage this to unify contributions in a great way. (https://github.com/ember-learn/guides-source/blob/d35a871a417e9c425a945369b849b0864cba1a23/.remarkrc.js has an example configuration for remark)
from docs.
Possibly also @SaschaMann as CI related, I think that's your wheelhouse - thoughts?
from docs.
Sounds good. Ideally it should add inline annotations or, better yet, suggestions to automatically fix the spelling mistake. Perhaps there are actions for it on the marketplace already. I think having it as a normal pass/fail check might be quite bothersome.
from docs.
Good suggestions both.
I'll look into it for PR. I'm not at all au fait with GitHub actions so it may take a wee while 😄 )
from docs.
Just as FYI here, life has got really busy since making above assertion. I'm having trouble fitting time in for even any v2 track maintenance effort. So if anyone else wants to pick this up until I get back to things, be my guest 😉
from docs.
This action has the most actions stars: https://github.com/marketplace/actions/github-spellcheck-action
- uses pyspelling
- aspell or hunspell
from docs.
Related Issues (20)
- How-to Docs: Creating a new concept exercise HOT 2
- How-to Docs: Implement a test case generator
- missing anchor links HOT 3
- Understanding the why of learning mode HOT 3
- Building - Practice Exercise Docs: Clarify how append file is rendered
- docker.md link broken on test runners page HOT 1
- Style guide question regarding capitalization of headers HOT 2
- links in this repo are not supposed to work when reading on GitHub
- Hello world
- General documentation about practice exercises
- README.md file under building/github has broken links HOT 4
- Suggestion - Remove "extra" link from building/github/README
- config-json.md: files.invalidator not documented? HOT 1
- Add documentation about giving hints to specific instruction steps HOT 2
- ci: consider adding `markdownlint` workflow
- lint: approaches/articles: `name` key should be called `title`
- lint: consider requiring that every file in an exercise directory is "used" HOT 1
- markdown spec: consider changing admonition syntax from tildes to backticks HOT 1
- lint: specify that `authors` and `contributors` are valid GitHub usernames
- lint: add rules for analyzer tags in track config and approaches config HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.