Lack of interest Use @since to document when new methods are added

This suggestion has been closed automatically because it did not receive enough votes over an extended period of time. If you wish to see this, please search for an open suggestion and, if you don't find any, post a new one.

digitalpoint

Well-known member
There's been a few times where I've used a XenForo method for something, only later to find out an older (but not super old) version of XenForo didn't have it. For example when I tried to use \XF\Entity\Thread::getContentUrl(), but realized it wasn't available in XF 2.1.

I'm not talking about going back and tagging old stuff (that would be an impossible task), but maybe going forward?

It would be nice if new methods had the @since phpDoc tag so IDEs can tell you how long that method has been there, would really help with situations like that, as it would look like so:

1676479347800.png

By adding @since...

PHP:
/**
 * Gets the content URL... duh.
 *
 * @since 2.2.0
 *
 * @return string
 */
public function getContentUrl(bool $canonical = false, array $extraParams = [], $hash = null)

It's literally the only thing WordPress does better than XenForo.
 
Last edited:
Upvote 6
This suggestion has been closed. Votes are no longer accepted.
Back
Top Bottom