diff --git a/docs/20_Checks/_index.md b/docs/20_Checks/_index.md
index e6dfff4d8a9f8c0c7bac01d98c90703b0eb0028d..b5f91e82c333cf0801fb5b503f3a55fe44f68b04 100644
--- a/docs/20_Checks/_index.md
+++ b/docs/20_Checks/_index.md
@@ -21,7 +21,7 @@ There is one include script used by all checks:
 * [check_dns_responsetime](check_dns_responsetime.md)
 * [check_eol](check_eol.md)
 * [check_fs_errors](check_fs_errors.md)
-* check_fs_writable
+* [check_fs_writable](check_fs_writable.md)
 * check_haproxy_health
 * check_haproxy_status
 * check_memory
diff --git a/docs/20_Checks/check_fs_writable.md b/docs/20_Checks/check_fs_writable.md
new file mode 100644
index 0000000000000000000000000000000000000000..9646a75455f14fa3eafd503a94ac066703a5a830
--- /dev/null
+++ b/docs/20_Checks/check_fs_writable.md
@@ -0,0 +1,68 @@
+# Check writable filesystem
+
+## Introduction
+
+**check_fs_writebale** checks in the given directories a file can be touched.
+The response is critical of one of the directory is not writable for the icinga client user. 
+
+## Requirements
+
+(none)
+
+## Syntax
+
+```txt
+./check_fs_writable -h
+______________________________________________________________________
+
+CHECK_FS_WRITABLE 
+v1.2
+
+(c) Institute for Medical Education - University of Bern
+Licence: GNU GPL 3
+______________________________________________________________________
+
+Check if a filesystem is readonly in given directories.
+In each of the given directories a random file will be touched.
+
+The response is critical of one of the directory is not writable
+for the icinga client user.
+
+SYNTAX:
+check_fs_writable [directory [more directories]]
+
+OPTIONS:
+
+    -h or --help   show this help.
+
+PARAMETERS:
+
+    DIRECTORY where to touch a temporary file
+              default directories:
+              /tmp /var/tmp
+
+EXAMPLE:
+
+    check_fs_writable /tmp /root /var/www
+
+```
+
+### Parameters
+
+Add directories to check.
+Set a directory that is writable for world or prepared to be accessible for the icinga user.
+
+## Examples
+
+`$ check_fs_writable` returns
+
+```txt
+OK: check if filesystem is writable in /tmp /var/tmp 
+
+--- touching something into /tmp
+    -rw-r--r-- 1 axel axel 0 27. Jul 16:00 /tmp/icinga_touch_testfile__7749_15502
+
+--- touching something into /var/tmp
+    -rw-r--r-- 1 axel axel 0 27. Jul 16:00 /var/tmp/icinga_touch_testfile__30551_11189
+
+```