diff --git a/README.md b/README.md
index d546882..e82aea4 100644
--- a/README.md
+++ b/README.md
@@ -29,3 +29,9 @@ shells your system have installed (and which shells you should have installed).
 
 ### OpenSuSE ###
 `zypper install <shell>`
+
+## Specifications ##
+Two simple flowcharts shows how this script is built, what it does and which
+files are installed/uninstalled with Makefile.
+The two flowcharts resides in this directory and are called
+flowchart\_makefile.png and flowchart\_shellchooser.png.
diff --git a/flowchart_makefile.png b/flowchart_makefile.png
new file mode 100644
index 0000000..98158d8
Binary files /dev/null and b/flowchart_makefile.png differ
diff --git a/flowchart_shellchooser.png b/flowchart_shellchooser.png
new file mode 100644
index 0000000..63c7062
Binary files /dev/null and b/flowchart_shellchooser.png differ