Update i18n docs

The i18n docs are hopelessly out of date for manual translations. This is an attempt to fix it up and make it more useful.
This note is not displaying properly, rst syntax is wrong. Should be:

```
.. note::
   Storing metadata....
```