improved doc

playbooks/roles/analytics-server/tasks/main.yml

@@ -13,15 +13,28 @@
 # Tasks for role analytics-server
 # 
 # Overview:
-# 
+#
+# Installs the edX analytics-server Django application which provides
+# basic analytics to the LMS instructor dashboard via service calls.
 #
 # Dependencies:
 #
+# Depends upon the automated role
 # 
 # Example play:
 #
+# - name: Configure analytics instance(s)
+#   hosts: analytics-servers
+#   sudo: True
+#   vars_files:
+#     - "{{ secure_dir }}/vars/common/common.yml"
+#     - "{{ secure_dir }}/vars/stage/analytics-server.yml"
+#     - "{{ secure_dir }}/vars/users.yml"
+#   gather_facts: True
+#   roles:
+#     - common
+#     - analytics-server
 #
-
 - name: analytics-server | install system packages
   apt: pkg={{','.join(as_debian_pkgs)}} state=present
   tags: