From 6989bd59d33d84cebf3e0ef134f4107d149c6fd5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 19 May 2022 17:22:34 +0200
Subject: [PATCH] Create building-your-site.md

---
 .github/dev-docs/building-your-site.md | 49 ++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 .github/dev-docs/building-your-site.md

diff --git a/.github/dev-docs/building-your-site.md b/.github/dev-docs/building-your-site.md
new file mode 100644
index 00000000..06fbdf16
--- /dev/null
+++ b/.github/dev-docs/building-your-site.md
@@ -0,0 +1,49 @@
+---
+priority: 25
+label: "Compiling to HTML"
+category: "Creating Content"
+---
+
+# Compiling to static HTML
+
+## Running the build command
+
+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
+```
+
+> Learn more about the options supported in the [console commands](console-commands#build-the-static-site) section.
+
+## More ways to build your site
+
+### Previewing your site live
+
+It can quickly become tedious to have to hop to your terminal to rebuild your site.
+
+The Hyde Realtime Compiler solves this problem by starting a development server that 
+automatically compiles your site on the fly. Start the server using the `serve` command:
+
+```bash
+php hyde serve          
+```
+
+> Learn more in the [console commands](console-commands#start-the-realtime-compiler) section.
+
+### Compiling a single file
+
+Using the php hyde build command is great and all that, but when you just need to update that one file
+it gets a little... overkill. To solve this problem, you can use the rebuild command to compile a single file:
+
+```bash
+php hyde rebuild <filepath>
+```
+> Learn more in the [console commands](console-commands#build-a-single-file) section.
+
+
+## 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!
\ No newline at end of file