Incorrect link format.

Are we not allowed to use markdown reference links? It certainly improves both readability and reuse when they are used rather than inline links.

@angrycub you're not and it's not wrong - I think we stick with inline since the benefits of reference are a bit marginal in comparison. We don't usually need to reuse links within the same doc (or shouldn't need to, really), and as we start to encourage more contributors, I prefer to keep it as approachable (and in-line) as possible

thanks for submitting this, @angrycub!

looking at the original next to the preview, aside from the beautifully realigned list items 🙌 , everything else looks the same.

For me, as I'm reading through the documentation "code," reference links force me to context switch and the “last mile” things knock me out of flow - reading the same sentence a few times. If there's something about the reference links or encoding that makes the docs easier to parse, I'd love to figure out a way we can make it better there, otherwise, I can push a commit to this branch to clean up the md a bit