Improve the translatable documentation

- fix formatting issues
- add translatable example
- explain which fields should go in which entity