diff --git a/readme.md b/readme.md
index fc5d7ed2..3f28bff6 100644
--- a/readme.md
+++ b/readme.md
@@ -47,7 +47,7 @@ Each entry in the `dex.json` file contains the following data (example):
   },
   "slug": {
     "eng": "charizard",
-    "jpn": "rizaadon",
+    "jpn": "riza-don",
     "jpn_ro": "lizardon"
   },
   "gen-7": {
@@ -86,7 +86,7 @@ Each entry in the `dex.json` file contains the following data (example):
 // ...
 ```
 
-The `name` and `slug` objects both contain two different versions of the Japanese name. The **`jpn`** item contains kana for the name, and a Hepburn rōmaji conversion for the `slug` (with duplicate vowels instead of macron characters, as they're inconvenient to type). The **`jpn_ro`** item contains GAME FREAK's official rōmaji names that are mainly used in merchandise. For example, for カメール (Wartortle), the `jpn` slug is *"kameeru"*, while the `jpn_ro` slug is *"kameil"*.
+The `name` and `slug` objects contain the Pokémon's name in various languages, including a romanized version of the Japanese name. The **`jpn_ro`** item contains GAME FREAK's official rōmaji names that are mainly used in merchandise. For example, for カメール (Wartortle), the `jpn` slug is *"kame-ru"*, while the `jpn_ro` slug is *"kameil"*.
 
 The **`forms`** object contains a list of all sprites pertaining to a Pokémon. It always contains at least a `"$"` (dollar sign) value, which means the regular form or default sprite. Each form object can contain the following details: