diff --git a/README.md b/README.md
new file mode 100644
index 0000000..80c58b2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+# My Advent of Code solutions, written as an exercise to learn Rust.
+
+To run, simply edit ´src/main.rs´ and run it. Optionally, set the year and day via ´ADVENT_YEAR´ and ´ADVENT_DAY´ environment variables. By setting ´ADVENT_TOKEN´ to your browser session token, your personal input can optionally be fetched automatically.
diff --git a/data/README.md b/data/README.md
new file mode 100644
index 0000000..df9e854
--- /dev/null
+++ b/data/README.md
@@ -0,0 +1 @@
+## The author of adventofcode.com, Eric Wastl, does not want puzzle input to be shared: https://adventofcode.com/about