diff --git a/common/script/src/content/pets-mounts/index.js b/common/script/src/content/pets-mounts/index.js
index 17fffccaf6..11c8fcd3d9 100644
--- a/common/script/src/content/pets-mounts/index.js
+++ b/common/script/src/content/pets-mounts/index.js
@@ -1,4 +1,21 @@
 import {transform, defaults} from 'lodash';
+
+//--------------------------------------------------
+// Pets and Mounts are generated by eggs * potions
+//
+// { <egg_key>-<potion_key>: true }
+//
+// <egg_key> - the key of the egg the animal hatched from
+// <potion_key> - the potion that hatched the animal
+//
+//--------------------------------------------------
+// Special Pets and Mounts
+// { <animal_type>-<fake_potion>: <transifex_key> }
+//
+// <animal_type> - could be existing animal or a totally new animal
+// <fake_potion> - if a unique animal, potion is Base, if it's a special version of an existing animal, the fake potion is a different from a normal hatching potion
+//--------------------------------------------------
+
 import hatchingPotions from '../hatching-potions';
 import dropEggs from '../eggs/drops';
 import questEggs from '../eggs/quest';
@@ -12,8 +29,8 @@ let dropMounts = generateAnimalSet(dropEggs);
 let questMounts = generateAnimalSet(questEggs);
 
 function generateAnimalSet(set) {
-  return transform(set, function(m, egg) {
-    defaults(m, transform(hatchingPotions, function(m2, pot) {
+  return transform(set, (m, egg) => {
+    defaults(m, transform(hatchingPotions, (m2, pot) => {
       return m2[egg.key + "-" + pot.key] = true;
     }));
   });
diff --git a/common/script/src/content/pets-mounts/special-mounts.js b/common/script/src/content/pets-mounts/special-mounts.js
index e2410e0945..cafb047b3d 100644
--- a/common/script/src/content/pets-mounts/special-mounts.js
+++ b/common/script/src/content/pets-mounts/special-mounts.js
@@ -1,5 +1,3 @@
-// special mounts are {key:i18n}
-
 let specialMounts = {
   'BearCub-Polar':       'polarBear',
   'LionCub-Ethereal':    'etherealLion',
diff --git a/common/script/src/content/pets-mounts/special-pets.js b/common/script/src/content/pets-mounts/special-pets.js
index 5097631c0e..e27d7ef531 100644
--- a/common/script/src/content/pets-mounts/special-pets.js
+++ b/common/script/src/content/pets-mounts/special-pets.js
@@ -1,5 +1,3 @@
-// special mounts are {key:i18n}
-
 let specialPets = {
   'Wolf-Veteran':      'veteranWolf',
   'Wolf-Cerberus':     'cerberusPup',