<div dir="ltr"><div dir="ltr">Hi DIG,<div><br></div><div>In today's DIG meeting, we looked at a tool called <a href="https://vale.sh/docs/">Vale</a> for automatically checking if our documentation is following best practices and <a href="https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:dig_style_guide">the DIG style guide</a>.  The tool looked potentially quite useful, and so we discussed implementing it with an incremental approach of:</div><div><ul><li>Configure vale in Github Actions with a single rule.</li><li>Use the list of problem areas provided by Github Actions to fix those areas</li><li>Confirm that Github Actions turns green when all those areas are fixed</li><li>Add another rule to Github Actions and repeat.</li></ul><div>That way, we don't have to learn all about how to write vale rules at once, nor do we face an overwhelming list of things to fix.</div></div><div><br></div><div>I did step one in the process (added a rule to make sure images in the docs have alt text).  If you are logged into github, you can see the results here: <a href="https://github.com/sandbergja/Evergreen/actions/runs/8839819500/job/24273972123">https://github.com/sandbergja/Evergreen/actions/runs/8839819500/job/24273972123</a></div><div><br></div><div>So... next step is to add alt text to those images!  Please feel free to make edits to <a href="https://github.com/sandbergja/Evergreen/tree/user/sandbergja/vale/docs/modules">my branch in the Github interface</a>.  Let me know if you have any questions about how to do this, I'm happy to hop onto a quick zoom.  I won't be able to make it to the next DIG meeting, but feel free to work on this/discuss this without me :-)</div><div><br></div><div>  -Jane</div></div></div>