diff --git a/doc/localization.adoc b/doc/localization.adoc
index 15790a7f7..001e61a7e 100644
--- a/doc/localization.adoc
+++ b/doc/localization.adoc
@@ -20,12 +20,13 @@ Translations will be send back to us regularly and will eventually appear in the
 
 [source,json]
 ----
-{ "pad.modals.connected": "Connecté."
-, "pad.modals.uderdup": "Ouvrir dans une nouvelle fenêtre."
-, "pad.toolbar.unindent.title": "Dèsindenter"
-, "pad.toolbar.undo.title": "Annuler (Ctrl-Z)"
-, "timeslider.pageTitle": "{{appTitle}} Curseur temporel",
-, ...
+{ 
+  "pad.modals.connected": "Connecté.",
+  "pad.modals.uderdup": "Ouvrir dans une nouvelle fenêtre.",
+  "pad.toolbar.unindent.title": "Dèsindenter",
+  "pad.toolbar.undo.title": "Annuler (Ctrl-Z)",
+  "timeslider.pageTitle": "{{appTitle}} Curseur temporel",
+  ...
 }
 ----
 
@@ -71,7 +72,7 @@ alert(window._('pad.chat'));
 ----
 ==== 2. Create translate files in the locales directory of your plugin
 
-* The name of the file must be the language code of the language it contains translations for (see https://joker-x.github.com/languages4translatewiki/test/[supported lang codes]; e.g. en ? English, es ? Spanish...)
+* The name of the file must be the language code of the language it contains translations for (see https://joker-x.github.io/languages4translatewiki/test/[supported lang codes]; e.g. en ? English, es ? Spanish...)
 * The extension of the file must be `.json`
 * The default language is English, so your plugin should always provide `en.json`
 * In order to avoid naming conflicts, your message keys should start with the name of your plugin followed by a dot (see below)
@@ -80,7 +81,8 @@ alert(window._('pad.chat'));
 
 [source, json]
 ----
-{ "ep_your-plugin.h1": "Heading 1"
+{ 
+  "ep_your-plugin.h1": "Heading 1"
 }
 ----
 
@@ -88,7 +90,8 @@ alert(window._('pad.chat'));
 
 [source, json]
 ----
-{ "ep_your-plugin.h1": "Título 1"
+{ 
+  "ep_your-plugin.h1": "Título 1"
 }
 ----
 
@@ -103,8 +106,9 @@ For example, if you want to replace `Chat` with `Notes`, simply add...
 
 [source,json]
 ----
-{ "ep_your-plugin.h1": "Heading 1"
-, "pad.chat": "Notes"
+{ 
+  "ep_your-plugin.h1": "Heading 1",
+  "pad.chat": "Notes"
 }
 ----