move readme to index

Since GitLab's web UI uses the index as the default page on the repo view.

1 files changed, 14 insertions, 3 deletions

diff --git a/index.md b/index.md
index 9bff6df..4f8a08a 100644
--- a/index.md
+++ b/index.md
@@ -2,12 +2,23 @@
 title: "About"
 ---
 
-# About this site
+# Markdown course website example / template
 
 This is an example of course website, divided into two parts: lectures and
 exercises sheets.
 
+Everything is generated from Markdown source files into static files which can
+then be served through by any web server.
 
-# Course plan
+For convenience, the compilation and deployment can be automated through GitLab
+CI or equivalent, which allows automatic publication of the latest version
+after pushing the sources to a version-controlled repository for example.
 
-* First lecture on the first day.
+
+## Resources and references
+
+- [Markdown syntax](https://daringfireball.net/projects/markdown/syntax)
+- [Quarto (reference)](https://quarto.org/docs/reference/index.html)
+- [Pandoc (manual)](https://pandoc.org/MANUAL.html)
+- [Nix guides](https://nixos.org/learn.html)
+- [GitLab CI configuration reference](https://docs.gitlab.com/ee/ci/yaml/)