Improved help.lint tool
Wednesday, December 12, 2007
The help.lint
tool ensures that code examples in documentation produce
the output that they claim to produce, and also checks that stack
effects in documentation match the source, as well as finding broken
links. I have made it easier to use, and no longer dependent on editor
integration. Now, you just run "my-vocab" check-vocab-help
, and any
problematic words are listed. It is best to run this from the UI, so
that the errors are clickable presentations. You can then right-click on
any word and choose “Edit” from the menu.
I encourage all contributors to run this tool against their documentation. Just as you should always run unit tests before releasing changes, you should always run this tool too.