diff --git a/docs/src/docs_best_practices/how-to/troubleshoot.md b/docs/src/docs_best_practices/how-to/troubleshoot.md
index 1c5d34dcd..7da589367 100644
--- a/docs/src/docs_best_practices/how-to/troubleshoot.md
+++ b/docs/src/docs_best_practices/how-to/troubleshoot.md
@@ -82,7 +82,7 @@ Pkg.add(["PowerSystems"]);
      2. Run the formatter once to format the rest of the file
      3. Add the text back in
      4. Add the `ignore` keyword argument with the file name to
-        [`JuliaFormatter.format`](@extref `JuliaFormatter.format-Tuple{Any}`) in `scripts/formatter/formatter_code.jl`
+        [`JuliaFormatter.format`](@extref JuliaFormatter.format) in `scripts/formatter/formatter_code.jl`
         to skip the file in the future:
 
 ```julia
diff --git a/docs/src/docs_best_practices/how-to/write_a_tutorial.md b/docs/src/docs_best_practices/how-to/write_a_tutorial.md
index 545fdd6c4..8483e3607 100644
--- a/docs/src/docs_best_practices/how-to/write_a_tutorial.md
+++ b/docs/src/docs_best_practices/how-to/write_a_tutorial.md
@@ -10,7 +10,7 @@ Sienna.
     the [difference between a tutorial and how-to guide](https://diataxis.fr/tutorials-how-to/)
     to refresh your memory and refer back throughout the process.
   - Look at an example: `PowerSystems.jl`'s
-    [Working with Time Series](https://sienna-platform.github.io/PowerSystems.jl/stable/tutorials/working_with_time_series/)
+    [Working with Time Series](@extref PowerSystems :doc:`tutorials/generated_working_with_time_series`)
 
 !!! warning
     
@@ -56,7 +56,7 @@ code blocks.
 !!! tip "Do"
     
     Display all code, starting from `using SomeSiennaPackage`. Example: See
-    [Working with Time Series](@extref tutorial_time_series).
+    [Working with Time Series](@extref PowerSystems :doc:`tutorials/generated_working_with_time_series`).
 
 !!! warning "Don't"