diff --git a/docs/index.md b/docs/index.md
index b24d2f4..d896aa3 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -25,3 +25,18 @@ File upload supports drag&drop, progress bar, pause and resume. Upload is chunke
 - No database required
 - Framework free [™](https://www.youtube.com/watch?v=L5jI9I03q8E)
 
+
+## Why Open Source on GitHub?
+
+There are several reasons why we switched to open source model and GitHub.
+
+Basically, we wanted to increase:
+
+- Code quality by bringing more developers on board
+- Code auditability and visibility
+- Security
+- Project lifetime
+
+At the end, the more people who can see and test a set of code, the more likely any flaws will be caught and fixed quickly.
+
+
diff --git a/docs/install.md b/docs/install.md
index b1425ee..35c2b66 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -11,3 +11,11 @@
 - Visit web page, if something goes wrong check ```/private/logs/app.log```
 - Login with default credentials ```admin/admin123```
 - Change default admin's password
+
+## Upgrade
+
+Since version 7 is completely rewriten from scratch, there is no clear upgrade path from the older versions.
+
+If you have an older version of FileGator please backup everything and install the script again.
+
+