Push pages for presentation

Author: c-git

content/misc/documentation_update.md

@@ -1,29 +1,37 @@
 +++
 title='Documentation Update'
 date=2023-10-27
-updated= 2025-05-24
+updated= 2025-12-03
 taxonomies = { tags = ["Misc"] }
 +++
 
 # Overview
 
+If you are looking for instructions on starting from scratch instead see [my notes](@/misc/site_setup.md) (WIP) on that.
+
 Top level folders under [content](https://github.com/c-git/c-git.github.io/tree/main/content) are sections and each has a
 `_index.md` that specifies the configuration parameters for that section.
 Then inside each folder you will find the pages for that section.
+I also mirror the section names as tag names to work with the [theme](https://github.com/jieiku/abridge/) I currently use.
+
+<details>
+  <summary>Historic information about how and why I set weights on sections</summary>
 
 To ensure that sections stay in alphabetical order we use manually set incrementing weights for each section.
 Initially the gap between the weights of sections is 50 and as sections are added in between we place them centered between their neighbours to reduce the frequency of needing to reweight.
 This allows us to keep them in alphabetical order even though sorting by title is not available for top level sections.
 We are using [zola](@/misc/zola.md), for more info on how it works see that page.
 
+</details>
+
 # Creating a section
 
 As stated in the [overview](#overview) each section has a `_index.md`.
 We only change the first two lines in that file and the other two always stay the same.
 Namely, we set:
 
 - `title` to an appropriate string and
-- `weight` we set so that is halfway between the one **before** it and the one **after** it.
+- `weight` we set so that is halfway between the one **before** it and the one **after** it. (Not needed at present but continued as it would be more work to do if needed in the future)
 
 # Creating a page
 

content/misc/site_setup.md

@@ -0,0 +1,25 @@
++++
+title='Site Setup Instructions'
+date = 2025-12-03
+taxonomies = { tags = ["Misc"] }
++++
+
+# Presentation Plan
+
+1. [Show live](@demo_page.md) site and [Templates](https://www.getzola.org/themes/)
+2. Briefly describe Static Site Generators (SSG)
+3. [Zola](https://www.getzola.org/)
+4. [Markdown](https://commonmark.org/help/)
+5. Briefly show what controls how github knows how to publish your site ([Github Actions](https://github.com/c-git/c-git.github.io/tree/main/.github/workflows))
+6. Make a corection to this page and push it live
+7. Create sample site
+8. Tooling recommendations / options
+   1. In browser only via github (Either limited hours with [codespaces](@/github/codespaces/index.md) or less convenient interface via their website)
+   2. Local with vscode and git (which I use)
+9. My additional notes on [markdown](@/misc/markdown.md)
+10. Cost
+    1. Hosting
+    2. Tools
+    3. Domain Registration
+    4. Support
+11. e-Commerce