cschan

Feel free to leave a message if you are interested in this topic.

sphinx-lint may be a good choice. However, currently it doesn't support the customized checkers that we need for zh-tw translation. I am considering whether we need to fork sphinx-lint for...

Some common mistakes (not limited to): - handle `::` in a wrong way. - Full-width and half-width parentheses, and the blank spaces. If the parentheses do not contain Mandarin characters,...

Thanks @ezio-melotti's contribution. We now have a basic linter now. Use `VERSION=3.12 make lint` to validate your reST syntax. So far, two files have not passed the linter check: ```...

Yes, that's right. Absolutely, it is much faster and more flexible for check processes development. Note that the current method is still not able to catch all the common mistakes...

Once linter is integrated with CI. We can close this issue.

@ezio-melotti Sure. Please help on this. Thank you!

Currently, sphinx-lint may not fully replace sphinx-build 100%. I mistyped :exc:`ValueError` as :exec:`ValueError`, which caused a build failure, but sphinx-lint didn't catch it.

Now even a single CI workflow takes around 27 minutes. In my opinion, we can consider checking `.rst` files ~~using `sphinx-build -b gettext`~~ when running CI. On the other hand,...

After investigating the `Makefile`, I found it is more practical to change the build target to "text". It is not elegant because it occupies extra space for text files. However,...