as per GaryJones notes, "You can't have tags come before the short / long description, otherwise the descriptions end up as part of a multiline tag."
removing these @TODO's until the team decides whether or not to replace them with something clearer, or to discuss it to the documentation
this helps with cleaner diffs. It's also on one of the PSRs, and it's one of the WPCS rules. (ht @garyjones for the reminder)
Signed-off-by: Tom McFarlin <tom@tommcfarlin.com>