Add comprehensive documentation and examples

docs/guides/README.md

@@ -0,0 +1,47 @@
+# PSProxmox Guides
+
+This directory contains guides for common tasks with the PSProxmox module.
+
+## Getting Started
+
+- [Installation Guide](Installation.md)
+- [Connection Guide](Connection.md)
+- [Authentication Methods](Authentication.md)
+
+## VM Management
+
+- [Creating VMs](Creating-VMs.md)
+- [Managing VMs](Managing-VMs.md)
+- [VM Templates](VM-Templates.md)
+- [VM Snapshots](VM-Snapshots.md)
+- [VM Migration](VM-Migration.md)
+
+## Cluster Management
+
+- [Cluster Setup](Cluster-Setup.md)
+- [Cluster Backup and Restore](Cluster-Backup-Restore.md)
+- [High Availability](High-Availability.md)
+
+## Storage Management
+
+- [Storage Types](Storage-Types.md)
+- [Managing Storage](Managing-Storage.md)
+- [Storage Replication](Storage-Replication.md)
+
+## Network Management
+
+- [Network Configuration](Network-Configuration.md)
+- [SDN Setup](SDN-Setup.md)
+- [Firewall Configuration](Firewall-Configuration.md)
+
+## User Management
+
+- [User and Role Management](User-Role-Management.md)
+- [Permissions and ACLs](Permissions-ACLs.md)
+- [API Tokens](API-Tokens.md)
+
+## Advanced Topics
+
+- [Automation and Scripting](Automation-Scripting.md)
+- [Performance Tuning](Performance-Tuning.md)
+- [Troubleshooting](Troubleshooting.md)