diff --git a/docs/README.md b/docs/README.md
index eaf4725c3..6aa4430e3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,16 +1,15 @@
 # Instructions for Building Documentation
 
 The documentation for the Discord.Net library uses [DocFX][docfx-main].
-[Instructions for installing this tool can be found here.][docfx-installing]
+Instructions for installing this tool can be found [here][docfx-installing].
 
 1. Navigate to the root of the repository.
-2. (Optional) If you intend to target a specific version, ensure that
- you have the correct version checked out.
-3. Build the docs using `docfx docs/docfx.json`. Add the `--serve`
+2. Build the docs using `docfx docs/docfx.json`. Add the `--serve`
  parameter to preview the site locally. Some elements of the page
-  may appear incorrect when not hosted by a server.
-      - Remarks: According to the docfx website, this tool does work on
-       Linux under Mono.
+ may appear incorrectly when hosted offline.
+
+Please note that if you intend to target a specific version, ensure that
+you have the correct version checked out.
 
 [docfx-main]: https://dotnet.github.io/docfx/
-[docfx-installing]: https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
+[docfx-installing]: https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
\ No newline at end of file