_____ _______ _ ___ _____
/ ____|__ __| |/ / | | __ \
| (___ | | | ' /| | | |__) |
\___ \ | | | < | | | _ /
____) | | | | . \| |____| | \ \
|_____/ |_| |_|\_\______|_| \_\
Pronounced 'stickler'.
My favourite feature of rust-doc (the tool that automatically generates documentation from a paticular kind of docstring you can use in rust codebases) is the keyword linking. My least favourite feature of rust-doc is trying to remember to do said linking, or syntax highlighting in general as, I usually edit markdown (what rust-doc essentially makes) in a specific tool for it.
So, I made a tool to do it for me -- if you too are like me, perhaps it'll not only bring you joy, but also up the quality of your crate's docs.
cargo install --git https://github.com/alphastrata/stklr
Backup your codebase before using this, use source-control.
stklr
# will bring up the help menu.stklr preview
#will show you changes it wants to make, changes are in green, source files and line numbers etc are all there.stklr fix
# will make changes to all the files you saw above, withpreview
.
- Make in issue/PR -- include the text that threw it off.
- not yet.
- later, not in beta stage.