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