Auto-update nav and content

Author: kerodri

.github/workflows/deploy.yml

@@ -25,17 +25,11 @@ jobs:
         run: |
           pip install mkdocs-material pyyaml
 
-      - name: Generate mkdocs.yml nav
-        run: python generate_nav.py
+      - name: Build MkDocs site (to verify)
+        run: mkdocs build --strict
 
       - name: Create CNAME file
         run: echo "tep.cyberpax.cloud" > docs/CNAME
 
-      - name: List built site contents (debug)
-        run: |
-          mkdocs build
-          echo "🔍 Site files:"
-          ls -R site/
-
       - name: Deploy to GitHub Pages
-        run: mkdocs gh-deploy --force
+        run: mkdocs gh-deploy --force

docs/Defender for Endpoint/Endpoint Detection and Response/Microsoft Defender Core Service/ecs_connectivity_diagnostic.md

@@ -10,7 +10,8 @@ This article provides a PowerShell-based diagnostic approach to validate and cap
 
 **ECS (Endpoint Configuration Service)** is a Microsoft cloud service used by Windows Defender and Microsoft Defender for Endpoint (MDE) clients to retrieve configuration data such as feature flags, diagnostic settings, and platform behavior instructions. ECS URLs are dynamically assigned and can vary based on region, tenant, or client configuration.
 
-> [ECS documentation: (https://learn.microsoft.com/en-us/defender-endpoint/microsoft-defender-core-service-overview)]
+> [ECS documentation](https://learn.microsoft.com/en-us/defender-endpoint/microsoft-defender-core-service-overview)
+
 
 ---
 

generate_nav.py

@@ -6,6 +6,13 @@
 IGNORE_DIRS = {"stylesheets", "__pycache__", "images"}
 IGNORE_FILES = {"_Sidebar.md", "index.md"}
 
+# Custom top-level order
+PRIORITY_ORDER = [
+    "Defender for Endpoint",
+    "Support Tips and Tools",
+    "Derecho informático"
+]
+
 def collect_docs(path):
     tree = []
     entries = sorted(os.listdir(path), key=str.casefold)
@@ -22,23 +29,53 @@ def collect_docs(path):
             tree.append({label: rel_path})
     return tree
 
+def sort_nav(nav):
+    prioritized = []
+    remaining = []
+
+    for item in nav:
+        section = list(item.keys())[0]
+        if section in PRIORITY_ORDER:
+            prioritized.append((PRIORITY_ORDER.index(section), item))
+        else:
+            remaining.append(item)
+
+    prioritized.sort(key=lambda x: x[0])
+    remaining.sort(key=lambda x: list(x.keys())[0].lower())
+    return [i[1] for i in prioritized] + remaining
+
 def build_mkdocs_config(nav):
-    with open("mkdocs.yml", "r", encoding="utf-8") as f:
+    config_path = "mkdocs.yml"
+
+    with open(config_path, "r", encoding="utf-8") as f:
         config = yaml.safe_load(f)
 
-    config["nav"] = [{"Home": "index.md"}] + nav
+    new_nav = [{"Home": "index.md"}] + sort_nav(nav)
+    config["nav"] = new_nav
 
-    with open("mkdocs.yml", "w", encoding="utf-8") as f:
+    with open(config_path, "w", encoding="utf-8") as f:
         yaml.dump(config, f, sort_keys=False, allow_unicode=True)
 
     print("✅ Navigation updated in mkdocs.yml")
 
 def git_commit_and_push():
+    # Check for any changes (staged or not)
+    result = subprocess.run(["git", "status", "--porcelain"], capture_output=True, text=True)
+    if result.stdout.strip() == "":
+        print("⚠️  No changes to commit.")
+        return
+
+    print("📦 Staging and committing changes...")
     subprocess.run(["git", "add", "."], check=True)
-    subprocess.run(["git", "commit", "-m", "Auto-update nav, commit changes, trigger deploy"], check=False)
+    subprocess.run(["git", "commit", "-m", "Auto-update nav and content"], check=False)
     subprocess.run(["git", "push", "origin", "main"], check=True)
+    print("✅ Git commit and push completed.")
 
 if __name__ == "__main__":
+    print("📁 Collecting docs...")
     nav = collect_docs(DOCS_DIR)
+
+    print("🧭 Building mkdocs.yml...")
     build_mkdocs_config(nav)
+
     git_commit_and_push()

mkdocs.yml

@@ -9,8 +9,6 @@ extra_css:
 - stylesheets/layout.css
 nav:
 - Home: index.md
-- Day-to-Day Stuff:
-  - Birthday Reminders: Day-to-Day Stuff/birthday-reminders.md
 - Defender for Endpoint:
   - Endpoint Detection and Response:
     - Alert Tunning:
@@ -35,11 +33,13 @@ nav:
     - Threat Vulnerability Management:
       - Troubleshooting Guide (Tsg) Cve‐2023‐49210 – Openssl Vulnerability In Node‐Openssl Npm Package: Defender
           for Endpoint/Endpoint Detection and Response/Threat Vulnerability Management/Troubleshooting-Guide-(TSG)-CVE‐2023‐49210-–-OpenSSL-Vulnerability-in-node‐openssl-NPM-Package.md
+- Support Tips and Tools:
+  - Effective Case Notation Good Practices And Template: Support Tips and Tools/Effective-Case-Notation-Good-practices-and-template.md
+  - How To Craft An Effective Root Cause Analysis (Rca): Support Tips and Tools/How-to-Craft-an-Effective-Root-Cause-Analysis-(RCA).md
 - Derecho informático:
   - Delitos Informáticos En Costa Rica Mapeo Jurídico‐Técnico Y Controles Att&Ck: Derecho
       informático/Delitos-Informáticos-en-Costa-Rica-Mapeo-Jurídico‐Técnico-y-Controles-ATT&CK.md
   - Reflexión, Bienes Jurídicos Tutelados En Una Eventual Legislación De Ia En Costa Rica: Derecho
       informático/Reflexión,-Bienes-jurídicos-tutelados-en-una-eventual-legislación-de-IA-en-Costa-Rica.md
-- Support Tips and Tools:
-  - Effective Case Notation Good Practices And Template: Support Tips and Tools/Effective-Case-Notation-Good-practices-and-template.md
-  - How To Craft An Effective Root Cause Analysis (Rca): Support Tips and Tools/How-to-Craft-an-Effective-Root-Cause-Analysis-(RCA).md
+- Day-to-Day Stuff:
+  - Birthday Reminders: Day-to-Day Stuff/birthday-reminders.md