While working on
DM-7892 I noticed that the old Doxygen guidelines on Confluence recommended the use of the @todo tag to flag unfinished code. This tag's output is collated on a moderately-well-hidden Doxygen page. (Curiously, the related tag @bug is not used anywhere.)
Given that we have an actual bug tracker, that lists of unresolved issues arguably do not belong in API documentation, and that I'm not sure the @todo list is actually read by anybody, I would like to avoid transferring rules regarding @todo from Confluence to http://developer.lsst.io, effectively removing them from the C++ style guide. John Swinbank suggested I RFC this change to see if anybody objects.
As an alternative to merely not mentioning @todo, we could make a stronger rule to the effect that the @todo tag should not be used, and that unfinished work should instead have a Jira ticket.