Yes. We need both structural element links and regular links in the description. Thanks for the link to the thread. That is exactly what we need.
On Wednesday, May 15, 2019 at 6:27:50 PM UTC+3, Google user wrote: > > why at all do you want to use the @link tag and don't want to use @see tag? > >> The @see tag indicates a reference from the associated "Structural >> Elements" to a website or other "Structural Elements". >> The @link tag indicates a custom relation between the associated >> "Structural Element" and a website, which is identified by an absolute URI. > > as we can see, the @link tag should be used for uris, and @see tag - for > structural elements. why you want to use @link tag for a structural element? > > or do you mean that you cannot use the @see tag inside a description using > the inline syntax? then why don't you propose to allow the inline syntax > for @see tag? > please support the following thread instead: > https://groups.google.com/forum/#!msg/php-fig/BQXbVm8OYDk/vRHMZfU4CwAJ > > otherwise, are you just proposing to make the @link tag just an alias to > the @see tag? what will be the difference between them if php-fig will > implement your proposition? i see no difference at all. can you point it > out for me please? > > On Tuesday, 14 May 2019 14:28:54 UTC+3, Alexander Makarov wrote: >> >> Currently in @see tag FQSEN is allowed: >> https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#512-see >> >> but it's not allowed in @link >> https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#56-link >> >> so there's no way to reference a class in the description such as: >> >> By default, {@link \Yii::$container} refers to a Container instance which >>> is used by {@link \Yii::createObject()} to create new object instances. >> >> >> For Yii we've invented our own syntax but we'd like to switch to standard >> one: >> >> By default, [[\Yii::$container]] refers to a Container instance which is >>> used by [[\Yii::createObject()]] to create new object instances. >> >> -- You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/0990a57e-f013-481a-8f18-8f25ddb600de%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
