Adjust several small parts of docs

- add home icon to the top of the page, linking to website (ux improvement)
- order software titles alphabetically
- describe provisioning script

Author: igorpecovnik

docs/User-Guide_Autoconfig.md

@@ -104,3 +104,19 @@ PRESET_USER_SHELL="bash"
     1. Copy the template with `cp extensions/preset-firstrun.sh userpatches/extensions/`
     2. Edit the template `userpatches/extensions/preset-firstrun.sh` according to your situation
     3. Build your Armbian image using the additional parameter `ENABLE_EXTENSIONS=preset-firstrun`
+
+## Provisioning script
+
+`/root/provisioning` is executed once as root after the first successful login, either manual or automated. It’s used to perform final system setup tasks like installing packages, configuring the system, or enabling services.
+
+The example script updates package lists, installs htop, sets a custom hostname.
+
+
+```bash title="/root/provisioning"
+#!/bin/bash
+set -e
+echo "Provisioning started"
+apt update && apt install -y htop
+hostnamectl set-hostname my-device
+echo "Provisioning complete"
+```

mkdocs.yml

@@ -133,26 +133,25 @@ nav:
         - 'Network': 'User-Guide_Armbian-Config/Network.md'
         - 'Localisation': 'User-Guide_Armbian-Config/Localisation.md'
   - 'ARMBIAN SOFTWARE':
-        - 'Overview': 'User-Guide_Armbian-Software.md'
-        - 'Web hosting': 'User-Guide_Armbian-Software/WebHosting.md'
-        - 'Containers': 'User-Guide_Armbian-Software/Containers.md'
+        - 'Armbian': 'User-Guide_Armbian-Software/Armbian.md'
         - 'Backup': 'User-Guide_Armbian-Software/Backup.md'
-#        - 'Desktops': 'User-Guide_Armbian-Software/Desktops.md'
-        - 'Music': 'User-Guide_Armbian-Software/Music.md'
-        - 'Finance': 'User-Guide_Armbian-Software/Finance.md'
+        - 'Containers': 'User-Guide_Armbian-Software/Containers.md'
         - 'Database': 'User-Guide_Armbian-Software/Database.md'
-        - 'Downloaders': 'User-Guide_Armbian-Software/Downloaders.md'
+        - 'Development tools': 'User-Guide_Armbian-Software/DevTools.md'
         - 'DNS blockers': 'User-Guide_Armbian-Software/DNS.md'
-        - 'Home Automation': 'User-Guide_Armbian-Software/HomeAutomation.md'
-        - 'Monitoring': 'User-Guide_Armbian-Software/Monitoring.md'
-        - 'Armbian': 'User-Guide_Armbian-Software/Armbian.md'
-        - 'DevTools': 'User-Guide_Armbian-Software/DevTools.md'
+        - 'Downloaders': 'User-Guide_Armbian-Software/Downloaders.md'
+        - 'Finance': 'User-Guide_Armbian-Software/Finance.md'
+        - 'Home automation': 'User-Guide_Armbian-Software/HomeAutomation.md'
         - 'Management': 'User-Guide_Armbian-Software/Management.md'
-        - 'Printing': 'User-Guide_Armbian-Software/Printing.md'
         - 'Media': 'User-Guide_Armbian-Software/Media.md'
+        - 'Monitoring': 'User-Guide_Armbian-Software/Monitoring.md'
+        - 'Music': 'User-Guide_Armbian-Software/Music.md'
         - 'Netconfig': 'User-Guide_Armbian-Software/Netconfig.md'
+        - 'Overview': 'User-Guide_Armbian-Software.md'
+        - 'Printing': 'User-Guide_Armbian-Software/Printing.md'
         - 'VPN': 'User-Guide_Armbian-Software/VPN.md'
-
+        - 'Web hosting': 'User-Guide_Armbian-Software/WebHosting.md'
+#        - 'Desktops': 'User-Guide_Armbian-Software/Desktops.md'
   - 'ARMBIAN BUILD FRAMEWORK' :
         - 'Overview' : 'Developer-Guide_Overview.md'
         - 'Getting Started' : 'Developer-Guide_Build-Preparation.md'

overrides/main.html

@@ -2,6 +2,12 @@
 
 <!-- Announcement bar -->
 {% block announce %}
+  <a href="https://www.armbian.com">
+    <span class="twemoji twitter">
+      {% include ".icons/fontawesome/solid/house.svg" %}
+    </span> &nbsp; www.armbian.com
+  </a>
+  &nbsp;
   <a href="https://github.com/sponsors/armbian">
     <span class="twemoji twitter">
       {% include ".icons/fontawesome/solid/heart.svg" %}