My preferred format and tag order of a PHP DocBlock

phpdoc.php

/**
 * One-line introduction followed by a full stop (for the title in some templates).
 *
 * @deprecated this should be prominent so I often put it at the top!
 * @todo Critical TODO ... this function doesn't work yet!
 *
 * A fuller paragraph detailing stuff.
 * A fuller paragraph detailing stuff.
 * A fuller paragraph detailing stuff.
 * @see is part of the detail
 * @example is part of the detail
 *
 * @todo following on from the detail - what's not been done.
 * @todo polishing not done, N2H's.
 *
 * @since 1.0.0
 * @throws and other technical aspecs I'd put here - if any.
 *
 * @param Then params in a block - in the ACTUAL order of the params
 * @param phpstorm always separates the last param from return
 * @param with blank line so i've started going with that!
 *
 * @return is always the last tag - makes sense.
 */

Credit to scipilot.
https://stackoverflow.com/questions/30235371/order-of-tags-in-the-php-doc#answer-30236482