diff --git a/README.md b/README.md
new file mode 100644
index 0000000..17f4181
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# aoc2019
+
+some advent of code solutions for 2019
+
+starting out with c#, we'll see how it goes this year
+
+using .net core 3.0, run all solutions with `dotnet run`