Restructure document flow

hydephp · May 19, 2022 · 40f4a3d · 40f4a3d
1 parent 48c2c24
commit 40f4a3d
Showing 1 changed file with 13 additions and 8 deletions.
diff --git a/.github/dev-docs/compile-and-deploy.md b/.github/dev-docs/compile-and-deploy.md
@@ -4,17 +4,20 @@ label: "Compile & Deploy"
 category: "Creating Content"
 ---
 
-# Compiling to static HTML
+# Compile and Deploy your site
 
 ## Running the build command
 
+### Compile the entire site to static HTML
 Now that you have some amazing content, you'll want to compile your site into static HTML.
 
 **This is as easy as executing the `build` command:**
 ```bash
 php hyde build
 ```
 
+### Other ways to compile the site
+
 **You can also compile a single file:**
 ```bash
 php hyde rebuild <filepath>
@@ -25,12 +28,20 @@ php hyde rebuild <filepath>
 php hyde serve
 ```
 
-**Learn more about these commands in the [console commands](console-commands) documentation:**
+### Further reading
+
+#### Learn more about these commands in the [console commands](console-commands) documentation:
 
 - [Build command](console-commands#build-the-static-site)
 - [Rebuild command](console-commands#build-a-single-file)
 - [Serve command](console-commands#start-the-realtime-compiler)
 
+
+#### Key Concept: Autodiscovery
+When building the site, Hyde will your source directories for files and compile them into static HTML using the appropriate layout depending on what kind of page it is. You don't have to worry about routing as Hyde takes care of that, including creating navigation menus!
+
+---
+
 ## Deploying your site
 
 One of the things that make static sites so enjoyable to work with is how easy it is to deploy them to the web.
@@ -66,9 +77,3 @@ deploys the site automatically when the source is updated. This is done in the [
 
 You can take a look at the workflow HydePHP.com uses to create your own workflow.
 [DocsCI build.yml on GitHub](https://github.com/hydephp/DocsCI/blob/master/.github/workflows/build.yml)
-
-
-## Concepts
-
-### Autodiscovery
-When building the site, Hyde will your source directories for files and compile them into static HTML using the appropriate layout depending on what kind of page it is. You don't have to worry about routing as Hyde takes care of that, including creating navigation menus!