There's nothing wrong with it, but I don't think this is a good place to put this info either. The sphinx documentation would be a better place to put a more detailed explanation with examples. As it is, someone who wants to do localization in JavaScript isn't just going to know to look at global.js.