Move README.md to root and update based on new layout
diff --git a/mkdocs/README.md b/README.md
similarity index 70%
rename from mkdocs/README.md
rename to README.md
index 177bc22..a8d3ad4 100644
--- a/mkdocs/README.md
+++ b/README.md
@@ -1,11 +1,10 @@
# Hawk website
-This repository hosts the [MkDocs](https://www.mkdocs.org) source code for the
-Eclipse Hawk website.
+This repository hosts the [MkDocs](https://www.mkdocs.org) source code for the Eclipse Hawk website.
## Development
-To work on the website, set up a Python 3 [virtualenv](https://virtualenv.pypa.io/en/latest/) environment and install the dependencies through `pip`:
+To work on the website, go into the `mkdocs` folder and set up a Python 3 [virtualenv](https://virtualenv.pypa.io/en/latest/) environment and install the dependencies through `pip`:
virtualenv -p python3 env
pip install -r requirements.txt
@@ -27,8 +26,4 @@
## Deployment
-After a new version of the website is ready and before you push, make sure you build it with:
-
- mkdocs build
-
-The repository has an `.htaccess` file which will silently redirect all requests to go through the `site` subfolder produced by MkDocs.
+After a new version of the website is ready and before you push, make sure you build it with the `build.sh` script inside `mkdocs`.
diff --git a/mkdocs/build.sh b/mkdocs/build.sh
index b9d1925..5949ebe 100755
--- a/mkdocs/build.sh
+++ b/mkdocs/build.sh
@@ -2,11 +2,20 @@
set -e
+# Go to the directory with this script
+cd "$(dirname "$(readlink -f "$0")")"
+
+# Create a Python virtualenv if it does not exist yet
if ! test -d env; then
virtualenv -p python3 env
fi
+# Generate the website
source env/bin/activate
pip install -r requirements.txt
mkdocs build
-rsync -ravz --delete --exclude mkdocs --exclude .git site/ ../
+
+# Synchronise with repository root
+rsync -ravz --delete \
+ --exclude mkdocs --exclude .git --exclude README.md \
+ site/ ../
