diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1e03eec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# Entity Framework - Dead Ball Zone
+This is a practice project to learn Entity Framework.
+
+Using the 1998 game [Dead Ball Zone](https://en.wikipedia.org/wiki/Dead_Ball_Zone) for inspiration.
+
+## .NET commands:
+
+### NuGet commands
+
+Install [Entity Framework Core NuGet package](https://www.nuget.org/packages/microsoft.entityframeworkcore):
+
+`dotnet add package Microsoft.EntityFrameworkCore --version 9.0.3`
+
+### Creation commands
+
+To list all available templates:
+
+`dotnet new -l`
+
+New class:
+
+`dotnet new class -n MyClass`
+
+adding to an existing solution:
+
+`dotnet sln add Data/Data.csproj`
+
+
+## Terms
+
+A **database-context** is an abstraction of the database structure in code.
+* It lists the models and their database table names.
+* It instantiates a database connection during the runtime of the application.
+* Allows configurations to be made in code. 
\ No newline at end of file