Annotate provider interfaces with best practices

[patrys]

For example describe what the expectations are for "symbol location": is it supposed to point to the name of a function, its signature or the entire implementation? Should hover provider's result be a function signature, its docstring or something entirely different?

Currently we rely on reverse-engineering extensions that ship with vscode itself.

[patrys]

Related: microsoft/language-server-protocol#132

[vscodebot]

This issue is being closed to keep the number of issues in our inbox on a manageable level, we are closing issues that are not going to be addressed in the foreseeable future: We look at the number of votes the issue has received and the number of duplicate issues filed. More details here. If you disagree and feel that this issue is crucial: We are happy to listen and to reconsider.

If you wonder what we are up to, please see our roadmap and issue reporting guidelines.

Thanks for your understanding and happy coding!