The code will not make things obvious because localisers do not read it. To get the message, it can be vital for the message to be documented. This prevents misunderstandings and consequently "user errors".
For all these reasons we are happy to say thanks to Aaron Schulz for documenting the FlaggedRevs messages. This software is quite abstract and this will make the life of our localisers so much more easy.
Yes, it may be that you can do with less documentation with agile. However, when processes rely on the availability and the quality of documentation, documenting means serious business.