From 1cf68abd4b5ef981f2d41dc05b32e5a3a8a17f5a Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Sat, 28 Apr 2018 17:19:22 +0800
Subject: [PATCH] Minor fixes for CONTRIBUTING.md and README.md

---
 docs/CONTRIBUTING.md | 24 +++++++-----------------
 docs/README.md       | 18 +++++++++---------
 2 files changed, 16 insertions(+), 26 deletions(-)

diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index 296b6d1cb..3c4ebac71 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -1,18 +1,18 @@
 # Contributing to Docs
 
-I don't really have any strict conditions for writing documentation, 
+We don't really have any strict conditions for writing documentation,
 but just keep these few guidelines in mind:
 
 * Keep code samples in the `guides/samples` folder
-* When referencing an object in the API, link to it's page in the 
-API documentation.
+* When referencing an object in the API, link to it's page in the
+ API documentation.
 * Documentation should be written in clear and proper English*
 
-\* If anyone is interested in translating documentation into other 
-languages, please open an issue or contact me on 
+\* If anyone is interested in translating documentation into other
+languages, please open an issue or contact me on
 Discord (`foxbot#0282`).
 
-### Layout
+## Layout
 
 Documentation should be written in a FAQ/Wiki style format.
 
@@ -33,14 +33,4 @@ Example of long link syntax:
 Please consult the [API Documentation] for more information.
 
 [API Documentation]: xref:System.String
-```
-
-### Compiling
-
-Documentation is compiled into a static site using [DocFx]. 
-We currently use the most recent build off the dev branch.
-
-After making changes, compile your changes into the static site with 
-`docfx`. You can also view your changes live with `docfx --serve`.
-
-[DocFx]: https://dotnet.github.io/docfx/
\ No newline at end of file
+```
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
index b483339c4..eaf4725c3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,16 +1,16 @@
 # 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]
+The documentation for the Discord.Net library uses [DocFX][docfx-main].
+[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 library. Run `dotnet build` in the root of this repository.
- Ensure that the build passes without errors.
-4. 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.
+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`
+ 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.
 
 [docfx-main]: https://dotnet.github.io/docfx/
 [docfx-installing]: https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html