Add localization documentation.

Also cleanup documentation.
Merge pull request #886 from glogiotatidis/docs-upgrade

Add localization documentation.