add: resolve links to symbols in markdown descriptions

[carsakiller]

Links like [mySymbol](lua://mySymbol) in a comment will now be resolved to a URI pointing to the actual file where mySymbol can be found.

I would also like to add highlighting and completion while you are writing so that [something](lua:// triggers completion of symbols – but I'm not sure where to even start for that.

This change will result in @see being pretty much useless. I never really used @see much due to formatting issues and it not looking quite right. Perhaps @see should be removed?

Closes #2175

[carsakiller]

@sumneko, would you be able to assist me in adding completion to the [mySymbol](lua://) syntax? From what I can gather, changes will need to be made to the parser to parse out the above from comments. I am not sure how this can be done and how it would then interface with the language server in order to allow us to provide suggestions.

[sumneko]

See

lua-language-server/script/core/completion/completion.lua

Line 2260 in adfac39

local function tryLuaDoc(state, position, results)

[carsakiller]

Okay, should be good to go 🙂