]> arthur.barton.de Git - ansible-collection-boilerplate.git/commitdiff
Add a bit more documentation
authorAlexander Barton <alex@barton.de>
Thu, 25 May 2023 15:16:04 +0000 (17:16 +0200)
committerAlexander Barton <alex@barton.de>
Thu, 25 May 2023 15:16:04 +0000 (17:16 +0200)
docs/playbooks.md [new file with mode: 0644]
docs/scripts.md [new file with mode: 0644]

diff --git a/docs/playbooks.md b/docs/playbooks.md
new file mode 100644 (file)
index 0000000..6c3c7b3
--- /dev/null
@@ -0,0 +1,8 @@
+# Ansible Boilerplate Collection Playbooks
+
+The Ansible Boilerplate Collection provides some playbooks which can be used by
+dependant projects. Those playbooks are stored in the `playbooks/` directory.
+
+## "ping" Play
+
+Run the Ansible "ping" module.
diff --git a/docs/scripts.md b/docs/scripts.md
new file mode 100644 (file)
index 0000000..ac0d43b
--- /dev/null
@@ -0,0 +1,20 @@
+# Ansible Boilerplate Collection Scripts
+
+The Ansible Boilerplate Collection contains some scripts which are stored in the
+`bin/` directory, in the project itself as well as in projects using the
+Boilerplate Collection.
+
+## "ansible-boilerplate" Script
+
+Management script for the Ansible Boilerplate Collection itself. Used to
+initialize new projects as well as upgrading (activating) dependent projects
+using this collection.
+
+## "a" Wrapper Script for "ansible" Command
+
+Wrapper for the `ansible` command.
+
+## "ap" and "aps" Wrapper Scripts for "ansible-playbook" Command
+
+The `ap` script is a wrapper for the `ansible-playbook` command. The `aps`
+script uses the `ap` command and runs it with the "site play".