diff --git a/CMakeLists.txt b/CMakeLists.txt
index 376db5e..3148e66 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -22,6 +22,12 @@ find_package(Threads REQUIRED)
 # Include directories
 include_directories(${CMAKE_SOURCE_DIR}/include)
 
+# Header-only library support
+# Add header-only libraries by creating interface libraries
+# Example: add_library(my_header_lib INTERFACE)
+#          target_include_directories(my_header_lib INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/external/my_header_lib/include)
+#          target_link_libraries(${EXEC_NAME} my_header_lib)
+
 # Add spdlog as a subdirectory
 add_subdirectory(external/spdlog)
 
diff --git a/README.md b/README.md
index 66d071e..f67c290 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,20 @@
-# project-euler-solutions
+# Project Euler Solutions
 
-solutions to the project euler questions that i wanted to solve
\ No newline at end of file
+This repository contains my solutions to Project Euler problems. Each solution includes both the code implementation and a markdown document explaining the approach and mathematical insights.
+
+## Structure
+
+- `src/` - Contains the actual code solutions
+- `solution-docs/` - Contains markdown documents explaining each solution in detail
+
+## How to Use
+
+1. Browse the `solution-docs/` directory to read problem explanations
+2. Check the corresponding code in `src/` to see implementations
+3. Run solutions with the appropriate language interpreter
+
+## Contributing
+
+Feel free to explore, learn, and suggest improvements. Solutions are written in [language] and aim to balance correctness, efficiency, and clarity.
+
+*Note: Solutions are shared for educational purposes. Please don't copy code directly for submission to Project Euler.*
\ No newline at end of file