How to get proper links in Intellisense?

KrisReeves

Hi there. I keep trying and failing to figure out how to format a PHPDoc that can link to either an external URL (with anchor text) or a docblock on another method. Is this supported? If so, is it documented anywhere? I can't find anything via google or forum search, and nothing I try according to the existing syntax on other sites seems to work either...

(also: is there any way to directly include a snippet from some other docblock? For example, text describing some argument's syntax that is shared among multiple functions...)

JakubMisek

Hello Kris,

You can use markdown syntax in PHPDoc:

Or @link tag:

Or just write URL in the summary:

Linking other elements is possible using @see tag, but we don't support clicking on it (yet):

--
I'm not aware that it's possible to "embed" PHPDoc from another element though.

KrisReeves

@see is what I was looking for, but I want to be able to click it, so this answers my question. I must be getting mixed up with other language servers in other contexts, because I was sure it was possible to click through to some referenced method

JakubMisek

KrisReeves, will be implemented; it's on the list.

We already do it in Microsoft Visual Studio.