diff --git a/KoogleApp.sln b/KoogleApp.sln
index 151bafb..aee3d7a 100644
--- a/KoogleApp.sln
+++ b/KoogleApp.sln
@@ -21,10 +21,14 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{242647DF-2
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{8EC462FD-D22E-90A8-E5CE-7E832BA40C5D}"
 	ProjectSection(SolutionItems) = preProject
-		build.md = build.md
 		CLAUDE.md = CLAUDE.md
 	EndProjectSection
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{63E5B7FE-38C2-47E8-9CF8-AB846B5B4281}"
+	ProjectSection(SolutionItems) = preProject
+		docs\build.md = docs\build.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
diff --git a/build.md b/docs/build.md
similarity index 62%
rename from build.md
rename to docs/build.md
index de08035..70a0fda 100644
--- a/build.md
+++ b/docs/build.md
@@ -1,26 +1,38 @@
 
-## EF Tools installieren
+# Entity Framework Core - Datenbank Migrationen und Updates
+
+## EF Tools installieren/aktualisieren
 ```
 dotnet tool update --global dotnet-ef --version 9.0.11
 ```
 
-
 ## Update-DB:
-```
+create migrations and update database for both DbContexts
 
+### AppDbContext
+create migrations for AppDbContext
+```
 dotnet ef migrations add [Initial_App] --project src/Koogle.Infrastructure --startup-project src/Koogle.Web --context AppDbContext --output-dir Data/Migrations
-dotnet ef database update -p src/Koogle.Infrastructure -s src/Koogle.Web --context AppDbContext
-
-dotnet ef migrations add [Initial_Auth] --project src/Koogle.Infrastructure --startup-project src/Koogle.Web --context AppIdentityDbContext --output-dir Identity/Migrations
-  
-
-
-dotnet ef database update -p src/Koogle.Infrastructure -s src/Koogle.Web --context AppIdentityDbContext
+```
+update database:
+```
 dotnet ef database update -p src/Koogle.Infrastructure -s src/Koogle.Web --context AppDbContext
 ```
 
+### AppIdentityDbContext
+create migrations for AppIdentityDbContext:
+```
+dotnet ef migrations add [Initial_Auth] --project src/Koogle.Infrastructure --startup-project src/Koogle.Web --context AppIdentityDbContext --output-dir Identity/Migrations
+```
+update database:
+```
+dotnet ef database update -p src/Koogle.Infrastructure -s src/Koogle.Web --context AppIdentityDbContext
+```
+
+
+# Tests
 
 ## Tests ausführen
 ```
-dotnet test tests/AIMS.Application.Tests
+dotnet test tests/Koogle.Application.Tests
 ```
\ No newline at end of file