Clean up references in doc comments in `lsp` crate (#4109)

This PR cleans up a handful of references in doc comments in the `lsp`
crate so that `rustdoc` will link and display them correctly.

Release Notes:

- N/A