[DOC] update readme, change main.yml (fix #1)

tasks/main.yml

@@ -1,20 +1,30 @@
 ---
 # Common setup tasks for all nodes (universial)
-# ATTENTION: This is just the maintenance version of the Common role. Run all
-# tasks during setup in this order:
-# - essentials
-# - tools
-# - usersetup
-# - usersettings
+# Usage:
+# - Run this whole role for setup
+# - You will do nothing wrong, if all steps are executed during periodocal maintenance
+# - Maintenance can be faster, if some steps are left out:
+#   - Some tasks are only needed for setup
+#   - Some can be run periodically
+#   - Some must run periodically
 
 - name: Install updates
   import_tasks: update.yml
 
+
+# if role has not changed, this will not be needed when just installing updates
 - name: Install essential tools
   import_tasks: essentials.yml
 
+# if role has not changed, this will not be needed when just installing updates
 - name: Install more tools
   import_tasks: tools.yml
 
+
+# this will just run once, because of a lock-file
+- name: Basics - Setup user shell
+  import_tasks: usersetup.yml
+
+# run this for every maintenance/ update cycle
 - name: Apply user settings
   import_tasks: usersettings.yml