Updated Define the Old Pokédex Order (markdown)

1 files changed, 31 insertions, 28 deletions

diff --git a/Define-the-Old-Pokédex-Order.md b/Define-the-Old-Pokédex-Order.md
index c2fe8c2..343b5eb 100644
--- a/Define-the-Old-Pokédex-Order.md
+++ b/Define-the-Old-Pokédex-Order.md
@@ -1,15 +1,15 @@
-[PLEASE EDIT] This tutorial is to be able to give the Old Pokédex order a different order other than by using the index order of the Pokémon themselves.
+This tutorial allows you to give the Old Pokédex mode a different order than the index order of the Pokémon themselves.
 
 
 ## Contents
 
 1. [Define Old Pokédex Order](#1-define-old-pokédex-order)
-2. [Edit how the old order gets found](#2-edit-how-the-old-order-gets-found)
+2. [Edit how Old Mode is ordered](#2-edit-how-old-mode-is-ordered)
 3. [Include in the ROM](#3-include-in-the-rom)
 
 ## 1. Define Old Pokédex Order
 
-Create **data/pokemon/dex_order_old.asm**. Pretty much the same as [constants/pokemon_constants.asm](../blob/master/constants/pokemon_constants.asm).
+Create **data/pokemon/dex_order_old.asm** in the same way as [data/pokemon/dex_order_new.asm](blob/master/data/pokemon/dex_order_new.asm).
 
 ```diff
 +OldPokedexOrder:
@@ -22,7 +22,24 @@ Create **data/pokemon/dex_order_old.asm**. Pretty much the same as [constants/po
 +	db CELEBI
 ```
 
-## 2. Edit how the old order gets found
+This defines the order in which the Pokémon will appear in the Old Mode Pokédex.
+
+And include this file in the ROM, such that it gets built.
+Edit [engine/pokedex/pokedex.asm](../blob/master/engine/pokedex/pokedex.asm)
+
+```diff
+ INCLUDE "data/pokemon/dex_order_alpha.asm"
+
+ INCLUDE "data/pokemon/dex_order_new.asm"
++
++INCLUDE "data/pokemon/dex_order_old.asm"
+
+ Pokedex_DisplayModeDescription:
+```
+
+## 2. Edit how Old Mode is ordered
+
+We're going to reuse the same code that's used for the New Mode Pokédex, but instead of using `NewPokedexOrder`, we're goint to tell it to use `OldPokedexOrder`. This ensures that the Pokémon are displayed in the order we want them to in the Old Mode Pokédex.
 
 Edit [engine/pokedex/pokedex.asm](../blob/master/engine/pokedex/pokedex.asm)
 
@@ -30,18 +47,18 @@ Edit [engine/pokedex/pokedex.asm](../blob/master/engine/pokedex/pokedex.asm)
 Pokedex_OrderMonsByMode:
 ...
  .NewMode:
-	 ld de, NewPokedexOrder
+ 	ld de, NewPokedexOrder
 +.do_dex
-	ld hl, wPokedexOrder
-	ld c, NUM_POKEMON
+ 	ld hl, wPokedexOrder
+ 	ld c, NUM_POKEMON
  .loopnew
-	ld a, [de]
-	inc de
-	ld [hli], a
-	dec c
-	jr nz, .loopnew
-	call .FindLastSeen
-	ret
+ 	ld a, [de]
+ 	inc de
+ 	ld [hli], a
+ 	dec c
+ 	jr nz, .loopnew
+ 	call .FindLastSeen
+ 	ret
 
  .OldMode:
 -	ld hl, wPokedexOrder
@@ -56,18 +73,4 @@ Pokedex_OrderMonsByMode:
 -	ret
 +	ld de, OldPokedexOrder
 +	jr .do_dex
-```
-
-## Include in ROM
-
-Edit [engine/pokedex/pokedex.asm](../blob/master/engine/pokedex/pokedex.asm)
-
-```diff
- INCLUDE "data/pokemon/dex_order_alpha.asm"
-
- INCLUDE "data/pokemon/dex_order_new.asm"
-+
-+INCLUDE "data/pokemon/dex_order_old.asm"
-
- Pokedex_DisplayModeDescription:
 ```
\ No newline at end of file