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

Docker for rake validate #488

Open
8BitJosh opened this issue Aug 28, 2023 · 4 comments
Open

Docker for rake validate #488

8BitJosh opened this issue Aug 28, 2023 · 4 comments

Comments

@8BitJosh
Copy link
Contributor

8BitJosh commented Aug 28, 2023

Add some sort of Docker based tool for validating (check links/spelling) the docs locally.

Currently the only way I have to do this is by opening a PR.
Using Ruby/ Rake on windows is a pain where docker would streamline this process.

@PeterJCLaw
Copy link
Member

Could you expand on why Ruby/Rake are a pain on Windows? Is this a general issue in the ecosystem or something specific to how we're set up? Would it be useful for example for us to have more info on how to set them up and/or guidance on e.g: using them under WSL (assuming that that might be better than under plain Windows)?

There already is a Docker setup I think in the docs repo, though I don't use it. I had thought it already supported running the validate stuff. Personally I find its presence is a negative as it makes the CI slower. I'm on Linux (Ubuntu) though, and am able to run everything locally. It also therefore wouldn't occur to me to update it if things changed, which means it's liable to get out of sync.

For spell checking if you're using VSCode I'd encourage installing the Code Spell Checker extension. That should run the same spell checker in your editor as we run in CI. This is the main reason that we use the checker package that we do. I see however that that wasn't being suggested to users of the repo though, I've fixed that now (copied over from the wesite repo).
I don't know if it's supported in other editors, though it feels like it easily could be.

@PeterJCLaw
Copy link
Member

#585 adds more information on how to run the checks locally.

@WillB97
Copy link
Contributor

WillB97 commented Mar 3, 2024

That doesn't solve this problem though. This is about being able to use the validate tools with docker, not running them locally.

@PeterJCLaw
Copy link
Member

#585 attempts to address the reason for this request -- that setting these up is hard, which I've assumed is due to lack of information about what's needed. I've asked for further information about why it's hard but haven't had a response -- hence the guesswork.

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

No branches or pull requests

3 participants