diff --git a/Readme.md b/Readme.md
index db4370a9709d52ddf64b17b5c41382a9235553b5..289b4a6ed2a99e2b02c780ee621d05ffaa7f66cb 100644
--- a/Readme.md
+++ b/Readme.md
@@ -1,11 +1,13 @@
 # AAI Login page
 
-A login page for multiple AAI organisations.
+A login page for Php applications with login from multiple AAI organisations.
+It offers a set or organisations (Identity providers) that can be filtered.
 
-* PHP
-* License: GNU GPL 3.0
-* Source: https://git-repo.iml.unibe.ch/iml-open-source/login-aai
-* Docs: see docs folder
+With it you can let login people with AAI / EDUGAIN on their own university and giv access tou your server.
+
+📜 License: GNU GPL 3.0 \
+📄 Source: <https://git-repo.iml.unibe.ch/iml-open-source/login-aai> \
+📗 Docs: <https://os-docs.iml.unibe.ch/login-aai>
 
 ⚠️ Work in progress!
 
diff --git a/docs/20_Features.md b/docs/20_Features.md
index 0babcd2a3bbddf6da017b9d3ab163eefa213cb77..edd1b086df07cf51f4c23bb81f2357e418804187 100644
--- a/docs/20_Features.md
+++ b/docs/20_Features.md
@@ -4,3 +4,5 @@
 * The list is filtered during typing in the search field. When entering multiple words all keywords must match.
 * The filter is stored in localstorage of the webbrowser. On reload or the next week the last filter will be activated.
 * A set of filter buttons by TLD will be generated. It is shown when minimum 2 TLDs were found.
+* An active shibboleth session will bedetected and hides the list of organisations
+* Multi language support; English and German language files are part of the project
diff --git a/docs/_index.md b/docs/_index.md
index 64428718b6395e186842ad07be945b22eb18e426..3a2efb1a900883231564d2f66cd1ac4389ab9a21 100644
--- a/docs/_index.md
+++ b/docs/_index.md
@@ -1,10 +1,13 @@
 # AAI Login page
 
-A login page for multiple AAI organisations.
+A login page for Php applications with login from multiple AAI organisations.
+It offers a set or organisations (Identity providers) that can be filtered.
 
-* PHP
-* License: GNU GPL 3.0
-* Source: https://git-repo.iml.unibe.ch/iml-open-source/login-aai
+With it you can let login people with AAI / EDUGAIN on their own university and giv access tou your server.
+
+📜 License: GNU GPL 3.0 \
+📄 Source: <https://git-repo.iml.unibe.ch/iml-open-source/login-aai> \
+📗 Docs: <https://os-docs.iml.unibe.ch/login-aai>
 
 ⚠️ Work in progress!