improve README

* Write about what this role does.
* Add sample playbook.
* Improve License section.

2 files changed, 15 insertions, 2 deletions

diff --git a/LICENSE b/LICENSE
new file mode 120000
index 0000000..d24842f
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1 @@
+COPYING
\ No newline at end of file
diff --git a/README.md b/README.md
index ce18e9a..c8140d5 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,18 @@
 # ansible bash configuration role
 
+This role installs a simple bashrc for the `remote_user` based on
+[sensible.bash](https://github.com/mrzool/bash-sensible) and a short aliases file.
+
+## Example playbook
+
+```ansible
+---
+- hosts: all
+  roles:
+    - bash
+```
+
 ## License
 
-This ansible role is licensed under the term of the GPLv3.
-For further information see the `COPYING` file or [](https://www.gnu.org/licenses/gpl-3.0.en.html).
+This ansible role is licensed under the term of the GPLv3.  
+For further information see the `COPYING` file or [https://www.gnu.org/licenses/gpl-3.0.en.html](https://www.gnu.org/licenses/gpl-3.0.en.html).