From 5f2c75591f85784f8113743c783843c25ba9f9bf Mon Sep 17 00:00:00 2001
From: Gergely Kovacs <anonymous.gergo@gmail.com>
Date: Tue, 10 Mar 2026 22:04:17 +0000
Subject: [PATCH] Fix: project initialisation issue

---
 DEVELOPMENT.md | 2 +-
 Makefile       | 4 ++--
 README.md      | 2 ++
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index 4d8026a..2399714 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -13,7 +13,7 @@
 Create a virtual environment and install dependencies:
 
 ```bash
-make venv
+make venv && source .venv/bin/activate
 make setup
 ```
 
diff --git a/Makefile b/Makefile
index 1af7be0..0a440dc 100644
--- a/Makefile
+++ b/Makefile
@@ -29,8 +29,8 @@ all: lock install upgrade lint test build
 venv:
 	@echo "🛠 Creating virtual environment..."
 	$(SYSTEM_PYTHON) -m venv .venv
-	@. ./.venv/bin/activate
-	@echo "✅ virtual environment created."
+	@echo "✅ virtual environment created. Activate it with:"
+	@echo "   source .venv/bin/activate"
 
 # Lock: Generates requirements.txt from pyproject.toml
 .PHONY: lock
diff --git a/README.md b/README.md
index 6fc636f..a9adad1 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@ Python Project Blueprint
 
 ## Development
 
+Please read the [DEVELOPMENT.md](./DEVELOPMENT.md) for development instructions.
+
 Check the [Makefile](./Makefile) for automation as the initial step, it defines all project commands.
 
 ### Make Commands