Documentation Restructure

blog/posts/05-16-2025-learning-to-leverage-gitea-runners.md

@@ -15,7 +15,7 @@ tags:
 ---
 
 # Learning to Leverage Gitea Runners
-When I first started my journey with a GitOps mentality to transition a portion of my homelab's infrastructure to an "**Intrastructure-as-Code**" structure, I had made my own self-made Docker container that I called the [Git-Repo-Updater](../../platforms/containerization/docker/custom-containers/git-repo-updater.md).  This self-made tool was useful to me because it copied the contents of Gitea repositories into bind-mounted container folders on my Portainer servers.  This allowed me to set up configurations for Homepage-Docker, Material MkDocs, Traefik Reverse Proxy, and others to pull configuration changes from Gitea directly into the production servers, causing them to hot-load the changes instantly. (within 10 seconds, give or take).
+When I first started my journey with a GitOps mentality to transition a portion of my homelab's infrastructure to an "**Intrastructure-as-Code**" structure, I had made my own self-made Docker container that I called the [Git-Repo-Updater](../../deployments/platforms/containerization/docker/custom-containers/git-repo-updater.md).  This self-made tool was useful to me because it copied the contents of Gitea repositories into bind-mounted container folders on my Portainer servers.  This allowed me to set up configurations for Homepage-Docker, Material MkDocs, Traefik Reverse Proxy, and others to pull configuration changes from Gitea directly into the production servers, causing them to hot-load the changes instantly. (within 10 seconds, give or take).
 
 ## Criticisms of Git-Repo-Updater
 When I made the [Git-Repo-Updater docker container stack](https://git.bunny-lab.io/container-registry/git-repo-updater), I ran into the issue of having made something I knew existing solutions existed for but simply did not understand well-enough to use yet.  This caused me to basically delegate the GitOps workflow to a bash script with a few environment variables, running inside of an Alpine Linux container.  While the container did it's job, it would occassionally have hiccups, caching issues, or repository branch errors that made no sense.  This lack of transparency and the need to build an entire VSCode development environment to push new docker package updates to Gitea's [package repository for Git-Repo-Updater](https://git.bunny-lab.io/container-registry/-/packages/container/git-repo-updater/latest) caused a lot of development headaches.
@@ -115,3 +115,4 @@ Gitea Act Runners are a beautiful thing, and it's a damn shame it took me this l
 
 ![Gitea_Runner_Screenshot](./Images/Gitea_Runner_Screenshot.png)
 
+

blog/posts/12-15-2024-openstack-frustrations.md

@@ -22,7 +22,7 @@ tags:
 So, I want to start with a little context.  As part of a long-standing project I have been working on, I have tried to deploy OpenStack.  OpenStack is sort of envisioned as "Infrastructure as a Service (IAAS)".  Basically you deploy an OpenStack cluster, which can run its own KVM for virtual machine and containers, or it can interface with an existing Hypervisor infrastructure, such as Hyper-V.  In most cases, people branch out the "Control", "Compute", and "Storage" roles into different physical servers, but in my homelab, I have been attempting to deploy it via a "Converged" model, of having Control, Compute, and Storage on each node, spanning a high-availability cluster of 3 nodes.
 
 ## The Problem
-The problems come into the overall documentation provided for deploying either [Canonical Openstack](https://ubuntu.com/openstack/install) which I have detailed my frustrations of the system in my own attempted re-write of the documentation [here](../../platforms/virtualization/openstack/canonical-openstack.md).  I have also attempted to deploy it via [Ansible OpenStack](https://docs.openstack.org/project-deploy-guide/openstack-ansible/2024.1/), whereas my documentation thus far in my homelab is visible [here](../../platforms/virtualization/openstack/ansible-openstack.md).
+The problems come into the overall documentation provided for deploying either [Canonical Openstack](https://ubuntu.com/openstack/install) which I have detailed my frustrations of the system in my own attempted re-write of the documentation [here](../../deployments/platforms/virtualization/openstack/canonical-openstack.md).  I have also attempted to deploy it via [Ansible OpenStack](https://docs.openstack.org/project-deploy-guide/openstack-ansible/2024.1/), whereas my documentation thus far in my homelab is visible [here](../../deployments/platforms/virtualization/openstack/ansible-openstack.md).
 
 You see, OpenStack is like icecream, it has many different ways to deploy it, and it can be as simple, or as overtly-complex as you need it to be, and it scales *really well* across a fleet of servers in a datacenter.  My problems come in where the Canonical deployment has never worked fully / properly, and their own development team is hesitant to recommend the current documentation, and the Ansible OpenStack deployment process, while relatively simple, requires a base of existing knowledge that makes translating the instructions into more user-friendly instructions in my homelab documentation a difficult task.  Eventually I want to automate much of the process as much as I can, but that will take time.
 
@@ -30,3 +30,4 @@ The common issue I've seen while trying to deploy OpenStack is understanding the
 
 I will post an update later if I figure things out!
 
+

deployments/automation/puppet/deployment/puppet-bolt.md

@@ -182,7 +182,7 @@ klist
 ### Prepare Windows Devices
 Windows devices need to be prepared ahead-of-time in order for WinRM functionality to work as-expected.  I have prepared a powershell script that you can run on each device that needs remote management functionality.  You can port this script based on your needs, and deploy it via whatever methods you have available to you.  (e.g.  Ansible, Group Policies, existing RMM software, manually via remote desktop, etc).
 
-You can find the [WinRM Enablement Script](../../ansible/enable-winrm-on-windows-devices.md) in the Bunny Lab documentation.
+You can find the [WinRM Enablement Script](../../../../workflows/operations/automation/ansible/enable-winrm-on-windows-devices.md) in the Bunny Lab documentation.
 
 ## Ad-Hoc Command Examples
 At this point, you should finally be ready to connect to Windows and Linux devices and run commands on them ad-hoc.  Puppet Bolt Modules and Plans will be discussed further down the road.

deployments/index.md

@@ -0,0 +1,15 @@
+---
+tags:
+  - Deployments
+  - Index
+  - Documentation
+---
+
+# Deployments
+## Purpose
+Build and deployment documentation for platforms, services, and automation stacks.
+
+## Includes
+- Platform deployments (virtualization and containerization)
+- Service deployments and integration patterns
+- Automation stack deployment guides

deployments/platforms/containerization/docker/custom-containers/git-repo-updater.md

@@ -5,7 +5,7 @@ tags:
   - Containerization
 ---
 
-**Purpose**: Docker container running Alpine Linux that automates and improves upon much of the script mentioned in the [Git Repo Updater](../../../../reference/bash/git-repo-updater.md) document.  It offers the additional benefits of checking for updates every 5 seconds instead of every 60 seconds.  It also accepts environment variables to provide credentials and notification settings, and can have an infinite number of monitored repositories.
+**Purpose**: Docker container running Alpine Linux that automates and improves upon much of the script mentioned in the [Git Repo Updater](../../../../../scripts/bash/git-repo-updater.md) document.  It offers the additional benefits of checking for updates every 5 seconds instead of every 60 seconds.  It also accepts environment variables to provide credentials and notification settings, and can have an infinite number of monitored repositories.
 
 ### Deployment
 You can find the current up-to-date Gitea repository that includes the `docker-compose.yml` and `.env` files that you need to deploy everything [here](https://git.bunny-lab.io/container-registry/-/packages/container/git-repo-updater/latest)

deployments/platforms/containerization/docker/deploy-portainer.md

@@ -54,7 +54,7 @@ Alternative Methods:
     2.  Be sure to set the `-v /srv/containers/portainer:/data` value to a safe place that gets backed up regularily.
 
 ### Configure Docker Network
-I highly recomment setting up a [Dedicated Docker MACVLAN Network](../../../networking/docker-networking/docker-networking.md).  You can use it to keep your containers on their own subnet.
+I highly recomment setting up a [Dedicated Docker MACVLAN Network](../../../../reference/infrastructure/networking/docker-networking/docker-networking.md).  You can use it to keep your containers on their own subnet.
 
 ### Access Portainer WebUI
 You will be able to access the Portainer WebUI at the following address: `https://<IP Address>:9443`

deployments/platforms/virtualization/proxmox/proxmoxve.md

@@ -20,7 +20,7 @@ You will need to download the [Proxmox VE 8.1 ISO Installer](https://www.proxmox
     ``` 
 
     1.  This tells Hyper-V to allow the GuestVM to behave as a hypervisor, nested under Hyper-V, allowing the virtualization functionality of the Hypervisor's CPU to be passed-through to the GuestVM.
-    2.  This tells Hyper-V to allow your GuestVM to have multiple nested virtual machines with their own independant MAC addresses.  This is useful when using nested Virtual Machines, but is also a requirement when you set up a [Docker Network](../../../networking/docker-networking/docker-networking.md) leveraging MACVLAN technology.
+    2.  This tells Hyper-V to allow your GuestVM to have multiple nested virtual machines with their own independant MAC addresses.  This is useful when using nested Virtual Machines, but is also a requirement when you set up a [Docker Network](../../../../reference/infrastructure/networking/docker-networking/docker-networking.md) leveraging MACVLAN technology.
 
 ### Networking
 You will need to set a static IP address, in this case, it will be an address within the 20GbE network.  You will be prompted to enter these during the ProxmoxVE installation.  Be sure to set the hostname to something that matches the following FQDN: `proxmox-node-01.MOONGATE.local`.

deployments/services/authentication/active-directory/certificate-services.md

@@ -16,9 +16,9 @@ This document outlines the Microsoft-recommended best practices for deploying a
 !!! note "Certificate Authority Server Provisioning Assumptions"
     - OS = Windows Server 2022/2025 bare-metal or as a VM  
     - You should give it at least 4GB of RAM.  
-    - [Change the edition of Windows Server from "**Evaluation**" to "**Standard**" via DISM](../../../operations/windows/change-windows-edition.md) 
+    - [Change the edition of Windows Server from "**Evaluation**" to "**Standard**" via DISM](../../../../workflows/operations/windows/change-windows-edition.md) 
     - Ensure the server is fully updated  
-    - [Ensure the server is activated](../../../operations/windows/change-windows-edition.md#force-activation-edition-switcher)
+    - [Ensure the server is activated](../../../../workflows/operations/windows/change-windows-edition.md#force-activation-edition-switcher)
     - Ensure the timezone is correctly configured
     - Ensure the hostname is correctly configured
 

index.md

@@ -5,29 +5,17 @@ This documentation details the design, setup, and day-to-day management of my ho
 ---
 
 ## Top-Level Sections
-**Foundations**
+**Deployments**
-- Conventions, templates, glossary, and shared standards
+- Platform, service, and automation deployment guides
 
-**Hardware**
+**Workflows**
-- Node build sheets, storage layouts, and physical inventory
+- Day-2 runbooks, maintenance procedures, and troubleshooting flows
 
-**Networking**
+**Scripts**
-- Addressing plans, firewall rules, VPNs, and network services
+- Quick-use Bash, PowerShell, and Batch scripts/snippets
-
-**Platforms**
-- Virtualization and containerization stacks (hypervisors, Kubernetes, Docker)
-
-**Services**
-- Deployable apps and services (auth, docs, email, monitoring, etc.)
-
-**Automation**
-- Ansible, Puppet, and workflow automation notes
-
-**Operations**
-- Runbooks for maintenance, backups, and troubleshooting
 
 **Reference**
-- Quick scripts and snippets for day-to-day tasks
+- Foundations, hardware inventory, and networking reference material
 
 **Blog**
 - Narrative posts and lessons learned
@@ -40,7 +28,7 @@ This documentation details the design, setup, and day-to-day management of my ho
     - **Personal Environment:** These docs reflect my own environment, goals, and risk tolerance.
     - **Security & Scale:** Approaches described here are suited to homelab or SMB use, and may need adjustments for enterprise-scale, regulatory compliance, or higher security standards.
     - **No Credentials:** All sensitive info is redacted or generalized.
-    - **Assumptions:** Some guides assume specific tools, e.g. [Portainer](./platforms/containerization/docker/deploy-portainer.md), [AWX](./automation/ansible/awx/deployment/awx-operator.md), etc. Substitute with your preferred tools as needed.
+    - **Assumptions:** Some guides assume specific tools, e.g. [Portainer](deployments/platforms/containerization/docker/deploy-portainer.md), [AWX](./deployments/automation/ansible/awx/deployment/awx-operator.md), etc. Substitute with your preferred tools as needed.
 
 ---
 
@@ -52,3 +40,4 @@ This documentation details the design, setup, and day-to-day management of my ho
 ---
 
 > _“Homelabs are for learning, breaking things, and sharing the journey. Hope you find something helpful here!”_
+

reference/foundations/documentation-restructure-migration-map.csv

@@ -0,0 +1,198 @@
+"current_path","proposed_path","doc_type","confidence","reason"
+"Blog/Index.md","blog/index.md","index","high","index-page"
+"Blog/Posts/01-22-2025 Windows Power Profiles Causing Notable CPU Performance Loss.md","blog/posts/01-22-2025-windows-power-profiles-causing-notable-cpu-performance-loss.md","blog","high","blog-root"
+"Blog/Posts/05-16-2025 Learning to Leverage Gitea Runners.md","blog/posts/05-16-2025-learning-to-leverage-gitea-runners.md","blog","high","blog-root"
+"Blog/Posts/12-15-2024 Implementing the Blog Plugin.md","blog/posts/12-15-2024-implementing-the-blog-plugin.md","blog","high","blog-root"
+"Blog/Posts/12-15-2024 OpenStack Frustrations.md","blog/posts/12-15-2024-openstack-frustrations.md","blog","high","blog-root"
+"index.md","index.md","index","high","index-page"
+"Infrastructure/Hardware/Cluster Node 01/Disk Arrays.md","reference/infrastructure/hardware/cluster-node-01/disk-arrays.md","reference","high","infrastructure-reference"
+"Infrastructure/Hardware/Cluster Node 02/Disk Arrays.md","reference/infrastructure/hardware/cluster-node-02/disk-arrays.md","reference","high","infrastructure-reference"
+"Infrastructure/Hardware/Cluster Node 03/Disk Arrays.md","reference/infrastructure/hardware/cluster-node-03/disk-arrays.md","reference","high","infrastructure-reference"
+"Infrastructure/Hardware/Index.md","reference/infrastructure/hardware/index.md","index","high","index-page"
+"Infrastructure/Hardware/Storage Node 01 Truenas Core/Disk Arrays.md","reference/infrastructure/hardware/storage-node-01-truenas-core/disk-arrays.md","reference","high","infrastructure-reference"
+"Infrastructure/Hardware/Storage Node 01 Truenas Core/Replacing a Drive.md","reference/infrastructure/hardware/storage-node-01-truenas-core/replacing-a-drive.md","reference","high","infrastructure-reference"
+"Infrastructure/Hardware/Storage Node 02 Truenas Scale/Disk Arrays.md","reference/infrastructure/hardware/storage-node-02-truenas-scale/disk-arrays.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Controllers/UniFi Controller.md","reference/infrastructure/networking/controllers/unifi-controller.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Controllers/UniFi Network Server Controller.md","reference/infrastructure/networking/controllers/unifi-network-server-controller.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Docker Networking/Creating a Macvlan Sub Interface for Docker.md","reference/infrastructure/networking/docker-networking/creating-a-macvlan-sub-interface-for-docker.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Docker Networking/Docker Networking.md","reference/infrastructure/networking/docker-networking/docker-networking.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Firewall and Routing/Sophos/Configure LAN Bridging.md","reference/infrastructure/networking/firewall-and-routing/sophos/configure-lan-bridging.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Firewall and Routing/Sophos/VPN/Site to Site VPNs/IPSEC/Automatic Tunnel Resetting.md","reference/infrastructure/networking/firewall-and-routing/sophos/vpn/site-to-site-vpns/ipsec/automatic-tunnel-resetting.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Firewall and Routing/Sophos/VPN/Site to Site VPNs/IPSEC/Tunnel Creation.md","reference/infrastructure/networking/firewall-and-routing/sophos/vpn/site-to-site-vpns/ipsec/tunnel-creation.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Firewall and Routing/Sophos/VPN/SSL VPN/Configuring Remote VPN RDP Access.md","reference/infrastructure/networking/firewall-and-routing/sophos/vpn/ssl-vpn/configuring-remote-vpn-rdp-access.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Index.md","reference/infrastructure/networking/index.md","index","high","index-page"
+"Infrastructure/Networking/IP Tables/172.16.16.0 Sophos Network.md","reference/infrastructure/networking/ip-tables/172-16-16-0-sophos-network.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/IP Tables/192.168.5.0 Container Network.md","reference/infrastructure/networking/ip-tables/192-168-5-0-container-network.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/IP Tables/Homelab Server Inventory.md","reference/infrastructure/networking/ip-tables/homelab-server-inventory.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Linux Networking/Modifying IP Address of Server.md","reference/infrastructure/networking/linux-networking/modifying-ip-address-of-server.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/Misc/Tuya Smart Lights.md","reference/infrastructure/networking/misc/tuya-smart-lights.md","reference","high","infrastructure-reference"
+"Infrastructure/Networking/VPN/Netbird.md","reference/infrastructure/networking/vpn/netbird.md","reference","high","infrastructure-reference"
+"Operations/Automation/Ansible/AWX/AWX Kerberos Implementation.md","workflows/operations/automation/ansible/awx/awx-kerberos-implementation.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/AWX/Connect AWX to Gitea.md","workflows/operations/automation/ansible/awx/connect-awx-to-gitea.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/AWX/Deployment/AWX in Minikube.md","deployments/automation/ansible/awx/deployment/awx-in-minikube.md","deployment","high","automation-deployment-folder"
+"Operations/Automation/Ansible/AWX/Deployment/AWX Operator.md","deployments/automation/ansible/awx/deployment/awx-operator.md","deployment","high","automation-deployment-folder"
+"Operations/Automation/Ansible/AWX/Deployment/Upgrading Issues past 2 10 0.md","deployments/automation/ansible/awx/deployment/upgrading-issues-past-2-10-0.md","deployment","high","automation-deployment-folder"
+"Operations/Automation/Ansible/Credentials/Custom Credential Types/WinRM.md","workflows/operations/automation/ansible/credentials/custom-credential-types/winrm.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/Credentials/Overview.md","workflows/operations/automation/ansible/credentials/overview.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/Enable WinRM on Windows Devices.md","workflows/operations/automation/ansible/enable-winrm-on-windows-devices.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/Inventories/Overview.md","workflows/operations/automation/ansible/inventories/overview.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/Playbooks/Playbooks.md","workflows/operations/automation/ansible/playbooks/playbooks.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/Projects/Overview.md","workflows/operations/automation/ansible/projects/overview.md","workflow","high","operations-root"
+"Operations/Automation/Ansible/Templates/Overview.md","workflows/operations/automation/ansible/templates/overview.md","workflow","high","operations-root"
+"Operations/Automation/Index.md","deployments/automation/index.md","index","high","index-page"
+"Operations/Automation/Puppet/Deployment/Puppet Bolt.md","deployments/automation/puppet/deployment/puppet-bolt.md","deployment","high","automation-deployment-folder"
+"Operations/Automation/Puppet/Deployment/Puppet.md","deployments/automation/puppet/deployment/puppet.md","deployment","high","automation-deployment-folder"
+"Operations/Backups and DR/Veeam Backup Replication/Backup Agent Takeover.md","workflows/operations/backups-and-dr/veeam-backup-replication/backup-agent-takeover.md","workflow","high","operations-root"
+"Operations/Backups and DR/Veeam Backup Replication/Core Veeam Concepts.md","workflows/operations/backups-and-dr/veeam-backup-replication/core-veeam-concepts.md","workflow","high","operations-root"
+"Operations/Backups and DR/Veeam Backup Replication/Manually Pruning Backups.md","workflows/operations/backups-and-dr/veeam-backup-replication/manually-pruning-backups.md","workflow","high","operations-root"
+"Operations/Backups and DR/Veeam Backup Replication/Migrating VMs to ProxmoxVE.md","workflows/operations/backups-and-dr/veeam-backup-replication/migrating-vms-to-proxmoxve.md","workflow","high","operations-root"
+"Operations/Backups and DR/Veeam Backup Replication/Migrating VSPC Backup Repositories.md","workflows/operations/backups-and-dr/veeam-backup-replication/migrating-vspc-backup-repositories.md","workflow","high","operations-root"
+"Operations/Backups and DR/Veeam Backup Replication/Retention Best Practices.md","workflows/operations/backups-and-dr/veeam-backup-replication/retention-best-practices.md","workflow","high","operations-root"
+"Operations/Backups and DR/Veeam Backup Replication/Troubleshooting/Failed to Validate Certificates of Some Gateways.md","workflows/operations/backups-and-dr/veeam-backup-replication/troubleshooting/failed-to-validate-certificates-of-some-gateways.md","workflow","high","operations-root"
+"Operations/Foundations/Documentation Styling.md","reference/foundations/documentation-styling.md","reference","high","foundations-reference"
+"Operations/Foundations/Index.md","reference/foundations/index.md","index","high","index-page"
+"Operations/Foundations/Templates/Document Template.md","reference/foundations/templates/document-template.md","reference","high","foundations-reference"
+"Operations/Hardware Management/ILO/Generic iLO Advanced License Keys.md","workflows/operations/hardware-management/ilo/generic-ilo-advanced-license-keys.md","workflow","high","operations-root"
+"Operations/Index.md","workflows/index.md","index","high","index-page"
+"Operations/Linux/Expand ISCSI Based ZFS Filesystem.md","workflows/operations/linux/expand-iscsi-based-zfs-filesystem.md","workflow","high","operations-root"
+"Operations/Linux/Expanding Linux Filesystems.md","workflows/operations/linux/expanding-linux-filesystems.md","workflow","high","operations-root"
+"Operations/Linux/Fedora Workstation/Full Setup.md","workflows/operations/linux/fedora-workstation/full-setup.md","workflow","high","operations-root"
+"Operations/Linux/Fedora Workstation/Install DE into Fedora Server.md","workflows/operations/linux/fedora-workstation/install-de-into-fedora-server.md","workflow","high","operations-root"
+"Operations/Linux/Fedora Workstation/Install Flatpak Apps.md","workflows/operations/linux/fedora-workstation/install-flatpak-apps.md","workflow","high","operations-root"
+"Operations/Linux/Fedora Workstation/Upgrading Versions.md","workflows/operations/linux/fedora-workstation/upgrading-versions.md","workflow","high","operations-root"
+"Operations/Power and UPS/APC Cell Wiring Diagram.md","workflows/operations/power-and-ups/apc-cell-wiring-diagram.md","workflow","high","operations-root"
+"Operations/Power and UPS/Battery Backup Power Distribution.md","workflows/operations/power-and-ups/battery-backup-power-distribution.md","workflow","high","operations-root"
+"Operations/Reference/Bash/Configure SSH Key Authentication.md","scripts/bash/configure-ssh-key-authentication.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Fix Displaylink Issues on Linux.md","scripts/bash/fix-displaylink-issues-on-linux.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Git Repo Updater.md","scripts/bash/git-repo-updater.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Install QEMU Guest Agent.md","scripts/bash/install-qemu-guest-agent.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Install XRDP.md","scripts/bash/install-xrdp.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Mdadm Grow Array Size.md","scripts/bash/mdadm-grow-array-size.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Open Port Checker.md","scripts/bash/open-port-checker.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/ProxmoxVE/Deeplab Rollback Script.md","scripts/bash/proxmoxve/deeplab-rollback-script.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Time Adjustment.md","scripts/bash/time-adjustment.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Transfer Docker Containers.md","scripts/bash/transfer-docker-containers.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Bash/Transfer Files with Netcat.md","scripts/bash/transfer-files-with-netcat.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Batch/Blue Iris/Server Watchdog.md","scripts/batch/blue-iris/server-watchdog.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Batch/Robocopy.md","scripts/batch/robocopy.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Index.md","scripts/index.md","index","high","index-page"
+"Operations/Reference/Powershell/Azure/Check Email Aliases.md","scripts/powershell/azure/check-email-aliases.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Azure/Connect to Azure AD.md","scripts/powershell/azure/connect-to-azure-ad.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Exchange Online/Connect to Exchange Online.md","scripts/powershell/exchange-online/connect-to-exchange-online.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Directory Walker.md","scripts/powershell/general-purpose/directory-walker.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/DNS Hierarchy Correction.md","scripts/powershell/general-purpose/dns-hierarchy-correction.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/File Finder.md","scripts/powershell/general-purpose/file-finder.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Fix Corrupted Windows Updates.md","scripts/powershell/general-purpose/fix-corrupted-windows-updates.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Force Gpupdate Domain Wide.md","scripts/powershell/general-purpose/force-gpupdate-domain-wide.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Inactive User Profile Data Cleanup.md","scripts/powershell/general-purpose/inactive-user-profile-data-cleanup.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Rclone.md","scripts/powershell/general-purpose/rclone.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Restart Service Domain Wide.md","scripts/powershell/general-purpose/restart-service-domain-wide.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/General Purpose/Windows 11 Upgrade via UNC Path.md","scripts/powershell/general-purpose/windows-11-upgrade-via-unc-path.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Hyper V/Collapse Differencing Disk Chains.md","scripts/powershell/hyper-v/collapse-differencing-disk-chains.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Hyper V/Delete Locked VHDX File.md","scripts/powershell/hyper-v/delete-locked-vhdx-file.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Hyper V/Failover Cluster/Force Reboot Remote Cluster Node.md","scripts/powershell/hyper-v/failover-cluster/force-reboot-remote-cluster-node.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Hyper V/Failover Cluster/Replication Bumper.md","scripts/powershell/hyper-v/failover-cluster/replication-bumper.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Minecraft Server/Update Script.md","scripts/powershell/minecraft-server/update-script.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Nextcloud/Upload Data to Nextcloud Share.md","scripts/powershell/nextcloud/upload-data-to-nextcloud-share.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Reporting/Get Password Expiration.md","scripts/powershell/reporting/get-password-expiration.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Reporting/Inactive Computers.md","scripts/powershell/reporting/inactive-computers.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/Reporting/Inactive Users.md","scripts/powershell/reporting/inactive-users.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/SMB/Detailed Permission Report All Shares.md","scripts/powershell/smb/detailed-permission-report-all-shares.md","scripts","high","script-reference-pattern"
+"Operations/Reference/Powershell/SMB/Top Level Permission Report All Shares.md","scripts/powershell/smb/top-level-permission-report-all-shares.md","scripts","high","script-reference-pattern"
+"Operations/Windows/Change Windows Edition.md","workflows/operations/windows/change-windows-edition.md","workflow","high","operations-root"
+"Operations/Windows/Delete Windows Recovery Partition.md","workflows/operations/windows/delete-windows-recovery-partition.md","workflow","high","operations-root"
+"Operations/Windows/VSS/Delete Shadow Copies.md","workflows/operations/windows/vss/delete-shadow-copies.md","workflow","high","operations-root"
+"Operations/Windows/Windows 11/Creating a Local Account on Win11.md","workflows/operations/windows/windows-11/creating-a-local-account-on-win11.md","workflow","high","operations-root"
+"Operations/Windows/Windows Server/SSL Certificates/Convert SSL Certificates into PFX Files.md","workflows/operations/windows/windows-server/ssl-certificates/convert-ssl-certificates-into-pfx-files.md","workflow","high","operations-root"
+"Platforms/Containerization/Docker/Custom Containers/Container Development.md","deployments/platforms/containerization/docker/custom-containers/container-development.md","deployment","high","platform-service-root"
+"Platforms/Containerization/Docker/Custom Containers/Git Repo Updater.md","deployments/platforms/containerization/docker/custom-containers/git-repo-updater.md","deployment","high","platform-service-root"
+"Platforms/Containerization/Docker/Deploy Portainer.md","deployments/platforms/containerization/docker/deploy-portainer.md","deployment","high","platform-service-root"
+"Platforms/Containerization/Kubernetes/Deployment/K8s.md","deployments/platforms/containerization/kubernetes/deployment/k8s.md","deployment","high","platform-service-root"
+"Platforms/Containerization/Kubernetes/Deployment/Rancher RKE2.md","deployments/platforms/containerization/kubernetes/deployment/rancher-rke2.md","deployment","high","platform-service-root"
+"Platforms/Containerization/Kubernetes/Migrating Docker Compose YML to K8s.md","workflows/platforms/containerization/kubernetes/migrating-docker-compose-yml-to-k8s.md","workflow","medium","platform-operations-keyword"
+"Platforms/Index.md","deployments/platforms/index.md","index","high","index-page"
+"Platforms/Virtualization/Hyper V/Failover Cluster/Deploy Failover Cluster Node.md","deployments/platforms/virtualization/hyper-v/failover-cluster/deploy-failover-cluster-node.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/Hyper V/Failover Cluster/Rebuild Failover Cluster Replication.md","workflows/platforms/virtualization/hyper-v/failover-cluster/rebuild-failover-cluster-replication.md","workflow","medium","platform-operations-keyword"
+"Platforms/Virtualization/Hyper V/Forcefully Stop GuestVM.md","workflows/platforms/virtualization/hyper-v/forcefully-stop-guestvm.md","workflow","medium","platform-operations-keyword"
+"Platforms/Virtualization/Hyper V/Kerberos Enabled VM Migration.md","workflows/platforms/virtualization/hyper-v/kerberos-enabled-vm-migration.md","workflow","medium","platform-operations-keyword"
+"Platforms/Virtualization/OpenStack/Ansible OpenStack.md","deployments/platforms/virtualization/openstack/ansible-openstack.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/OpenStack/Canonical OpenStack.md","deployments/platforms/virtualization/openstack/canonical-openstack.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/Proxmox/Cloud Init Templates/Ubuntu Server.md","deployments/platforms/virtualization/proxmox/cloud-init-templates/ubuntu-server.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/Proxmox/Common Tasks.md","workflows/platforms/virtualization/proxmox/common-tasks.md","workflow","medium","platform-operations-keyword"
+"Platforms/Virtualization/Proxmox/Configuring ISCSI Based Cluster Storage.md","deployments/platforms/virtualization/proxmox/configuring-iscsi-based-cluster-storage.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/Proxmox/Operations/Manually Activate Volume Group.md","workflows/platforms/virtualization/proxmox/operations/manually-activate-volume-group.md","workflow","high","platform-operations-folder"
+"Platforms/Virtualization/Proxmox/Operations/Upgrade PVE from 8 to 9.md","workflows/platforms/virtualization/proxmox/operations/upgrade-pve-from-8-to-9.md","workflow","high","platform-operations-folder"
+"Platforms/Virtualization/Proxmox/ProxmoxVE.md","deployments/platforms/virtualization/proxmox/proxmoxve.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/Proxmox/ZFS Over ISCSI.md","deployments/platforms/virtualization/proxmox/zfs-over-iscsi.md","deployment","high","platform-service-root"
+"Platforms/Virtualization/Rancher Harvester/Harvester.md","deployments/platforms/virtualization/rancher-harvester/harvester.md","deployment","high","platform-service-root"
+"Services/Asset Management/Homebox.md","deployments/services/asset-management/homebox.md","deployment","high","platform-service-root"
+"Services/Asset Management/Snipe IT.md","deployments/services/asset-management/snipe-it.md","deployment","high","platform-service-root"
+"Services/Authentication/Active Directory/Certificate Services.md","deployments/services/authentication/active-directory/certificate-services.md","deployment","high","platform-service-root"
+"Services/Authentication/Active Directory/Group Policy/Desktop Shortcut to UNC Path.md","deployments/services/authentication/active-directory/group-policy/desktop-shortcut-to-unc-path.md","deployment","high","platform-service-root"
+"Services/Authentication/Active Directory/LDAP Settings.md","deployments/services/authentication/active-directory/ldap-settings.md","deployment","high","platform-service-root"
+"Services/Authentication/Active Directory/Restore Domain Trust.md","deployments/services/authentication/active-directory/restore-domain-trust.md","deployment","high","platform-service-root"
+"Services/Authentication/Authelia.md","deployments/services/authentication/authelia.md","deployment","high","platform-service-root"
+"Services/Authentication/Authentik.md","deployments/services/authentication/authentik.md","deployment","high","platform-service-root"
+"Services/Authentication/Keycloak/Deployment.md","deployments/services/authentication/keycloak/deployment.md","deployment","high","platform-service-root"
+"Services/Authentication/Keycloak/OAuth2/Deployment.md","deployments/services/authentication/keycloak/oauth2/deployment.md","deployment","high","platform-service-root"
+"Services/Authentication/Keycloak/OAuth2/Gitea OAuth2.md","deployments/services/authentication/keycloak/oauth2/gitea-oauth2.md","deployment","high","platform-service-root"
+"Services/Authentication/Keycloak/OAuth2/Portainer OAuth2.md","deployments/services/authentication/keycloak/oauth2/portainer-oauth2.md","deployment","high","platform-service-root"
+"Services/Authentication/Privacyidea.md","deployments/services/authentication/privacyidea.md","deployment","high","platform-service-root"
+"Services/Automation Tools/Activepieces.md","deployments/services/automation-tools/activepieces.md","deployment","high","platform-service-root"
+"Services/Automation Tools/Node Red.md","deployments/services/automation-tools/node-red.md","deployment","high","platform-service-root"
+"Services/Automation Tools/Semaphore UI.md","deployments/services/automation-tools/semaphore-ui.md","deployment","high","platform-service-root"
+"Services/Backup/Kopia.md","deployments/services/backup/kopia.md","deployment","high","platform-service-root"
+"Services/Communication/Niltalk.md","deployments/services/communication/niltalk.md","deployment","high","platform-service-root"
+"Services/Communication/Rocketchat/Autotask Regex Replacer.md","deployments/services/communication/rocketchat/autotask-regex-replacer.md","deployment","high","platform-service-root"
+"Services/Communication/Rocketchat/Deployment.md","deployments/services/communication/rocketchat/deployment.md","deployment","high","platform-service-root"
+"Services/cPanel/Creating Email Server.md","deployments/services/cpanel/creating-email-server.md","deployment","high","platform-service-root"
+"Services/Dashboards/Dashy.md","deployments/services/dashboards/dashy.md","deployment","high","platform-service-root"
+"Services/Dashboards/Homepage Docker.md","deployments/services/dashboards/homepage-docker.md","deployment","high","platform-service-root"
+"Services/DevOps/Gitea.md","deployments/services/devops/gitea.md","deployment","high","platform-service-root"
+"Services/DNS/AdGuard Home.md","deployments/services/dns/adguard-home.md","deployment","high","platform-service-root"
+"Services/DNS/Pi Hole.md","deployments/services/dns/pi-hole.md","deployment","high","platform-service-root"
+"Services/DNS/Windows Server/Best Practices.md","deployments/services/dns/windows-server/best-practices.md","deployment","high","platform-service-root"
+"Services/Documentation/Docusaurus.md","deployments/services/documentation/docusaurus.md","deployment","high","platform-service-root"
+"Services/Documentation/Material MkDocs.md","deployments/services/documentation/material-mkdocs.md","deployment","high","platform-service-root"
+"Services/Documentation/zensical.md","deployments/services/documentation/zensical.md","deployment","high","platform-service-root"
+"Services/Edge/Nginx.md","deployments/services/edge/nginx.md","deployment","high","platform-service-root"
+"Services/Edge/Traefik.md","deployments/services/edge/traefik.md","deployment","high","platform-service-root"
+"Services/Email/iRedMail/Deploy iRedMail.md","deployments/services/email/iredmail/deploy-iredmail.md","deployment","high","platform-service-root"
+"Services/Email/iRedMail/Query SMTP Outgoing Queue.md","deployments/services/email/iredmail/query-smtp-outgoing-queue.md","deployment","high","platform-service-root"
+"Services/Email/iRedMail/Quick Server Settings.md","deployments/services/email/iredmail/quick-server-settings.md","deployment","high","platform-service-root"
+"Services/Email/Mailcow.md","deployments/services/email/mailcow.md","deployment","high","platform-service-root"
+"Services/Email/Microsoft Exchange/Configuring ACME Letsencrypt Bot.md","deployments/services/email/microsoft-exchange/configuring-acme-letsencrypt-bot.md","deployment","high","platform-service-root"
+"Services/Email/Microsoft Exchange/Preparing for Cumulative Updates.md","deployments/services/email/microsoft-exchange/preparing-for-cumulative-updates.md","deployment","high","platform-service-root"
+"Services/Email/Microsoft Exchange/Scripts/DAG/Database Management.md","scripts/services/email/microsoft-exchange/dag/database-management.md","scripts","high","script-reference-pattern"
+"Services/Email/Microsoft Exchange/Scripts/Restart Exchange Services.md","scripts/services/email/microsoft-exchange/restart-exchange-services.md","scripts","high","script-reference-pattern"
+"Services/Email/Microsoft Exchange/Scripts/Set Mailbox Auto Reply.md","scripts/services/email/microsoft-exchange/set-mailbox-auto-reply.md","scripts","high","script-reference-pattern"
+"Services/File Services/Windows Server/DFS Namespaces with Replication.md","deployments/services/file-services/windows-server/dfs-namespaces-with-replication.md","deployment","high","platform-service-root"
+"Services/Gaming/Ark Survival Ascended.md","deployments/services/gaming/ark-survival-ascended.md","deployment","high","platform-service-root"
+"Services/Gaming/Pterodactyl.md","deployments/services/gaming/pterodactyl.md","deployment","high","platform-service-root"
+"Services/Gaming/Valheim.md","deployments/services/gaming/valheim.md","deployment","high","platform-service-root"
+"Services/Home and IOT/Frigate.md","deployments/services/home-and-iot/frigate.md","deployment","high","platform-service-root"
+"Services/Home and IOT/HomeAssistant.md","deployments/services/home-and-iot/homeassistant.md","deployment","high","platform-service-root"
+"Services/Index.md","deployments/services/index.md","index","high","index-page"
+"Services/Media and Gaming/Emulatorjs.md","deployments/services/media-and-gaming/emulatorjs.md","deployment","high","platform-service-root"
+"Services/Media and Gaming/Pyload.md","deployments/services/media-and-gaming/pyload.md","deployment","high","platform-service-root"
+"Services/Microsoft 365/Change MFA Settings.md","deployments/services/microsoft-365/change-mfa-settings.md","deployment","high","platform-service-root"
+"Services/Monitoring/Gatus.md","deployments/services/monitoring/gatus.md","deployment","high","platform-service-root"
+"Services/Monitoring/Speedtest Tracker.md","deployments/services/monitoring/speedtest-tracker.md","deployment","high","platform-service-root"
+"Services/Monitoring/UptimeKuma.md","deployments/services/monitoring/uptimekuma.md","deployment","high","platform-service-root"
+"Services/Notifications/Ntfy.md","deployments/services/notifications/ntfy.md","deployment","high","platform-service-root"
+"Services/Productivity/Collabora Code Server.md","deployments/services/productivity/collabora-code-server.md","deployment","high","platform-service-root"
+"Services/Productivity/Nextcloud AIO.md","deployments/services/productivity/nextcloud-aio.md","deployment","high","platform-service-root"
+"Services/Productivity/Nextcloud.md","deployments/services/productivity/nextcloud.md","deployment","high","platform-service-root"
+"Services/Productivity/OnlyOffice EE.md","deployments/services/productivity/onlyoffice-ee.md","deployment","high","platform-service-root"
+"Services/Productivity/Stirling PDF.md","deployments/services/productivity/stirling-pdf.md","deployment","high","platform-service-root"
+"Services/Productivity/Trilium.md","deployments/services/productivity/trilium.md","deployment","high","platform-service-root"
+"Services/Productivity/Wordpress.md","deployments/services/productivity/wordpress.md","deployment","high","platform-service-root"
+"Services/Remote Access/Apache Guacamole.md","deployments/services/remote-access/apache-guacamole.md","deployment","high","platform-service-root"
+"Services/Remote Access/Firefox.md","deployments/services/remote-access/firefox.md","deployment","high","platform-service-root"
+"Services/RMM/TacticalRMM.md","deployments/services/rmm/tacticalrmm.md","deployment","high","platform-service-root"
+"Services/Security and Utility/Changedetection.md","deployments/services/security-and-utility/changedetection.md","deployment","high","platform-service-root"
+"Services/Security and Utility/Cyberchef.md","deployments/services/security-and-utility/cyberchef.md","deployment","high","platform-service-root"
+"Services/Security and Utility/IT Tools.md","deployments/services/security-and-utility/it-tools.md","deployment","high","platform-service-root"
+"Services/Security and Utility/Password Pusher.md","deployments/services/security-and-utility/password-pusher.md","deployment","high","platform-service-root"
+"Services/Security and Utility/Searx.md","deployments/services/security-and-utility/searx.md","deployment","high","platform-service-root"
+"Services/Security and Utility/Vaultwarden.md","deployments/services/security-and-utility/vaultwarden.md","deployment","high","platform-service-root"

reference/foundations/documentation-restructure-proposal.md

@@ -0,0 +1,113 @@
+---
+tags:
+  - Documentation
+  - Foundations
+  - Restructure
+---
+
+# Documentation Restructure Proposal (v2)
+
+## Audit Snapshot (2026-02-26)
+- Total markdown files: `197`
+- Current root split:
+  - `Operations`: `77`
+  - `Services`: `71`
+  - `Infrastructure`: `22`
+  - `Platforms`: `21`
+  - `Blog`: `5`
+  - Root `index.md`: `1`
+- Broken relative markdown links found: `38`
+- Proposed type split:
+  - `deployments`: `85`
+  - `workflows`: `37`
+  - `scripts`: `39`
+  - `reference`: `22`
+  - `blog`: `4`
+  - `index`: `10`
+
+## Why Navigation Feels Hard
+1. The current structure mixes two different axes:
+   - By domain (`Platforms`, `Services`, `Infrastructure`)
+   - By purpose (`Operations`, `Reference`, `Deployment`, `Scripts`)
+2. Task-oriented docs are scattered:
+   - Example: deployment docs exist in `Platforms`, `Services`, and `Operations/Automation/.../Deployment`.
+3. Naming/link style drift is high:
+   - Many links use lowercase-kebab paths while files still use title case and spaces.
+   - This mismatch is a major contributor to broken links and poor discoverability.
+
+## Target IA (Content-Type First)
+```text
+index.md
+blog/
+  index.md
+  posts/
+
+deployments/
+  index.md
+  platforms/
+  services/
+  automation/
+
+workflows/
+  index.md
+  operations/
+  platforms/
+
+scripts/
+  index.md
+  bash/
+  powershell/
+  batch/
+  services/
+
+reference/
+  index.md
+  foundations/
+  infrastructure/
+```
+
+## Folder Mapping Rules
+1. `Operations/Reference/**` -> `scripts/**`
+2. `Services/**/Scripts/**` -> `scripts/services/**`
+3. `Operations/**` (except reference + deployment docs) -> `workflows/operations/**`
+4. Platform operations/day-2 docs -> `workflows/platforms/**`
+5. `Platforms/**` deployment/setup docs -> `deployments/platforms/**`
+6. `Services/**` deployment/setup docs -> `deployments/services/**`
+7. `Operations/Automation/**/Deployment/**` -> `deployments/automation/**`
+8. `Infrastructure/**` + `Operations/Foundations/**` -> `reference/**`
+9. Normalize all destination paths to lowercase-kebab-case.
+
+## Generated Migration Artifact
+- Full proposed path map: `reference/foundations/documentation-restructure-migration-map.csv`
+- Columns:
+  - `current_path`
+  - `proposed_path`
+  - `doc_type`
+  - `confidence`
+  - `reason`
+
+## Manual Review Queue (Medium Confidence)
+1. `Platforms/Containerization/Kubernetes/Migrating Docker Compose YML to K8s.md`
+2. `Platforms/Virtualization/Hyper V/Failover Cluster/Rebuild Failover Cluster Replication.md`
+3. `Platforms/Virtualization/Hyper V/Forcefully Stop GuestVM.md`
+4. `Platforms/Virtualization/Hyper V/Kerberos Enabled VM Migration.md`
+5. `Platforms/Virtualization/Proxmox/Common Tasks.md`
+
+## Phased Migration Sequence
+1. Phase 0: stabilize naming and links
+   - Lock naming convention: lowercase-kebab-case directories and files.
+   - Move only index pages first (`10` files) to establish new top nav.
+2. Phase 1: move scripts (`39` files)
+   - Lowest blast radius, immediate usability improvement.
+3. Phase 2: move workflows (`37` files)
+   - Consolidates day-2 operations and runbooks.
+4. Phase 3: move deployments (`85` files)
+   - Largest move set, do after scripts/workflows are stable.
+5. Phase 4: cleanup and verification
+   - Fix all internal links, remove old folders, and validate build output.
+
+## Guardrails For Future Docs
+1. Keep one primary intent per doc: `deployment`, `workflow`, `script`, or `reference`.
+2. Require an `index.md` in every first-level and second-level folder.
+3. Use stable cross-links with root-relative paths after migration.
+4. Avoid adding new docs to legacy roots once migration starts.