diff --git a/docs/Documentation/Porting your Romhack.md b/docs/Documentation/Porting your Romhack.md
index 0767e98..5e6a217 100644
--- a/docs/Documentation/Porting your Romhack.md	
+++ b/docs/Documentation/Porting your Romhack.md	
@@ -143,9 +143,9 @@ but is not necessary if you are not using it.
   the RSP with `SPCameraWorld`. For OoT, this is not trivial because the game
   rendering creates and sets the view matrix in the main DL, then renders the
   game contents, then updates the camera, and finally retroactively modifies the
-  view matrix at the beginning of the main DL. See the code in `docs/Code/Camera.md`.
+  view matrix at the beginning of the main DL. See the code in @ref camera.
 - For specular lighting: Set the `size` field of any `Light_t` and `PosLight_t`
   to an appropriate value based on the game engine parameters for that light.
 - For the occlusion plane: Bring the code from `cpu/occlusionplane.c` into your
   game and follow the included instructions.
-- For the performance counters: See `docs/Code/Counters.md`.
+- For the performance counters: See @ref counters.
diff --git a/docs/code.md b/docs/code.md
index 130e7c0..5433b94 100644
--- a/docs/code.md
+++ b/docs/code.md
@@ -1,5 +1,6 @@
 # Code
-You can find more details about camera [here](@ref Camera) and counters [here](@ref Counters).
+You can find more details about camera [here](@ref camera) and counters [here](@ref counters).
 
-@subpage camera 
-@subpage counters
\ No newline at end of file
+related pages:
+- @subpage camera 
+- @subpage counters
\ No newline at end of file
diff --git a/docs/documentation.md b/docs/documentation.md
index 44d1bc6..605dfd3 100644
--- a/docs/documentation.md
+++ b/docs/documentation.md
@@ -1,14 +1,7 @@
 # Documentation
-- [Backwards Compatibility with F3DEX2](@ref compatibility)
-- [Microcode Configuration](@ref microcode)
-- [Design Tradeoffs](@ref design-tradeoffs)
-- [What happened to the clipping minimal scanlines algorithm?](@ref minimal-scanlines)
-- [Performance Results](@ref performance)
-- [Porting Your Romhack Codebase to F3DEX3](@ref porting)
-
-@subpage compatibility
-@subpage microcode
-@subpage design-tradeoffs
-@subpage minimal-scanlines
-@subpage performance
-@subpage porting
\ No newline at end of file
+- @subpage compatibility
+- @subpage microcode
+- @subpage design-tradeoffs
+- @subpage minimal-scanlines
+- @subpage performance
+- @subpage porting