Localization notes

Localizers usually work on the localizable files without the context of the source files including the localized strings; it is important to add comments to the localizable files itself, too. These comments are generally referred to as localization notes. There is an established format for those, which is described in this document.

DTD files 

<!-- LOCALIZATION NOTE (entity name): comment -->

properties files 

# LOCALIZATION NOTE (key): comment

File-wide comments should use the same format, be at the top of the file (after the license header, though) and just drop the (entity name/key) reference.