Restructure documentation layout

docs/CONTRIBUTING.md

@@ -25,6 +25,7 @@ Style consistencies:
 
 * Use a ruler set at 70 characters
 * Links should use long syntax
+* Pages should be short and concise, not broad and long
 
 Example of long link syntax:
 

docs/guides/toc.yml

@@ -1,17 +1,18 @@
-
-- name: Installing
-  href: installing.md
 - name: Getting Started
-  href: intro.md
+  items:
-- name: Terminology
+    - name: Installation
-  href: terminology.md
+      href: getting_started/installing.md
-- name: Logging
+    - name: Your First Bot
-  href: logging.md
+      href: getting_started/intro.md
-- name: Commands
+    - name: Terminology
-  href: commands.md
+      href: getting_started/terminology.md
+- name: Basic Concepts
+  items:
+    - name: Logging Data
+      href: concepts/logging.md
+    - name: Working with Events
+      href: concepts/events.md
+    - name: Entities
+- name: The Command Service
 - name: Voice
-  href: voice.md
+- name: Migrating from 0.9
-- name: Events
-  href: events.md
-- name: Code Samples
-  href: samples.md

docs/guides/voice/sending-voice.md

@@ -1,24 +1,13 @@
-# Voice
+---
+title: Sending Voice
+---
 
 **Information on this page is subject to change!**
 
 >[!WARNING]
->Audio in 1.0 is incomplete. Most of the below documentation is untested.
+>Audio in 1.0 is in progress
 
-## Installation
+## Installing
-
-To use Audio, you must first configure your [DiscordSocketClient] 
-with Audio support.
-
-In your [DiscordSocketConfig], set `AudioMode` to the appropriate 
-[AudioMode] for your bot. For most bots, you will only need to use 
-`AudioMode.Outgoing`.
-
-[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
-[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
-[AudioMode]: xref:Discord.Audio.AudioMode
-
-### Dependencies
 
 Audio requires two native libraries, `libsodium` and `opus`. 
 Both of these libraries must be placed in the runtime directory of your 

docs/toc.yml

@@ -1,8 +1,6 @@
 
 - name: Guides
   href: guides/
-- name: Migrating
-  href: migrating.md
 - name: API Documentation
   href: api/
   homepage: api/index.md