Improve docs (#37)

* fix markdown lint

* ida script instructions

* hactool instructions

Author: boreals-back-again

docs/BUILDING.md

@@ -1,4 +1,5 @@
 # Building
+
 The decomp toolchain was created for Linux & MacOS users. While it isn't a hard requirement, if you're running Windows its advised that you [setup WSL](https://learn.microsoft.com/en-us/windows/wsl/install) with an Ubuntu-like distro for the easiest setup.
 
 The instructions below assume you're running a form of Linux (WSL or native).
@@ -8,7 +9,7 @@ The instructions below assume you're running a form of Linux (WSL or native).
 * Python 3.6 or newer with [pip](https://pip.pypa.io/en/stable/installation/)
 * Ninja
 * CMake 3.13+
-    * If you are on Ubuntu 18.04, you must
+  * If you are on Ubuntu 18.04, you must
       first [update CMake by using the official CMake APT repository](https://apt.kitware.com/).
 * ccache (to speed up builds)
 * llvm-objdump
@@ -40,9 +41,16 @@ Additionally, you'll also need:
 
 2. Run `git submodule update --init --recursive`
 
-    Next, you'll need to acquire the **original v1.0.17 `main` NSO executable**.
+3. Acquire the **original v1.0.17 `main` NSO executable**.
+    1. Acquire an NSP dump of v1.0.17. [Dumping guide](https://zeldamods.org/wiki/Help:Dumping_games#Switch)
+    2. Setup [hactool](https://github.com/SciresM/hactool) and configure your dumped `title.keys`.
+    3. Run `hactool [path to the NSP] -t pfs0 --outdir=extracted`.
+    4. `cd` into `extracted`.
+    5. Find the largest NCA.
+    6. Run `hactool [path to largest NCA] -t nca --exefsdir=exefs`
+    7. `exefs/main` is the NSO.
 
-3. Run `tools/setup.py [path to the NSO]`
+4. Run `tools/setup.py [path to the NSO]`
     * This will:
         * install tools/check to check for differences in decompiled code
         * convert the executable if necessary

docs/CONTRIBUTING.md

@@ -1,4 +1,5 @@
 # Contributing
+
 As this project is in its very early stages, its hard to put guidelines on something that will evolve over time as contributors gain a better understanding of the game's internals.
 
 While almost all source paths aren't known, a few .cpp file names do appear in the Wii U Edition's global static constructors, along with a couple asserts giving file paths. Follow these file names wherever possible.

docs/DECOMPILERS.md

@@ -1,14 +1,17 @@
 # Decompilers
 
 ## IDA Pro
-1. Install `nxo64.py` from `reswitched/loaders`. Instructions are available [here](https://github.com/reswitched/loaders?tab=readme-ov-file#installation)
+
+1. Install `nxo64.py` from `reswitched/loaders`.  [Instructions](https://github.com/reswitched/loaders?tab=readme-ov-file#installation)
 2. Open `ida64.exe` and disassemble `main.nso`.
+3. To use scripts, click `File->Script File` and select the script you want to use.  
 
 ## Ghidra
+
 ### Setup Instructions
 
-1. Setup `Ghidrathon`. Instructions are available [here](https://github.com/mandiant/Ghidrathon#installing-ghidrathon). Make sure `Ghidrathon` has access to the `toml` package.
-2. Setup `Ghidra Switch Loader`. Instructions are available [here](https://github.com/Adubbz/Ghidra-Switch-Loader).
+1. . Setup [Ghidrathon](https://github.com/mandiant/Ghidrathon). Make sure `Ghidrathon` has access to the `toml` package.
+2. Setup [Ghidra Switch Loader](https://github.com/Adubbz/Ghidra-Switch-Loader).
 3. Create a new project. When importing `main.nso`, click `Options`. Then set `Base Address` to `0x7100000000`.
 4. Open the `Script Manager` (green play icon) from Ghidra's toolbar.
 5. Click on Manage Script Directories (bullet points icon) inside the Script Manager, and add `tools/ghidra`. Do not add `tools/common/ghidra_scripts`.