From 1c0159a7488ed1f6e6fa7c1e8a2b38413703fa83 Mon Sep 17 00:00:00 2001
From: sreea05 <258596614+sreea05@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:10:24 +0100
Subject: [PATCH 1/2] Enhance README contents

---
 README.md | 42 +++++++++++++++++++++++++++++-------------
 1 file changed, 29 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 24a4175..1aee471 100644
--- a/README.md
+++ b/README.md
@@ -8,19 +8,35 @@ A **template** C++ library exposed to Python via [pybind11](https://github.com/p
 
 ## Table of contents
 
-- [Project structure](#project-structure)
-- [Prerequisites](#prerequisites)
-- [Quick start](#quick-start)
-- [Building](#building)
-- [Running tests](#running-tests)
-- [Test coverage](#test-coverage)
-- [Lint and format](#lint-and-format)
-- [Documentation](#documentation)
-- [Building the Python package](#building-the-python-package)
-- [CI/CD](#cicd)
-- [Usage](#usage)
-- [Recipe reference](#recipe-reference)
-- [Customizing this template](#customizing-this-template)
+- [cpp-python](#cpp-python)
+  - [Table of contents](#table-of-contents)
+  - [Project structure](#project-structure)
+  - [Prerequisites](#prerequisites)
+  - [Quick start](#quick-start)
+  - [Building](#building)
+  - [Running tests](#running-tests)
+    - [C++ tests (Google Test)](#c-tests-google-test)
+    - [Python tests (pytest)](#python-tests-pytest)
+  - [Test coverage](#test-coverage)
+    - [C++ coverage (gcovr)](#c-coverage-gcovr)
+    - [Python coverage (pytest-cov)](#python-coverage-pytest-cov)
+  - [Lint and format](#lint-and-format)
+    - [Python (ruff)](#python-ruff)
+    - [C++ (clang-format)](#c-clang-format)
+    - [Type checking (mypy)](#type-checking-mypy)
+    - [Pre-commit hook](#pre-commit-hook)
+  - [Documentation](#documentation)
+    - [C++ API docs (Doxygen + Sphinx)](#c-api-docs-doxygen--sphinx)
+    - [Python API docs (Sphinx)](#python-api-docs-sphinx)
+  - [Building the Python package](#building-the-python-package)
+  - [CI/CD](#cicd)
+  - [Usage](#usage)
+  - [Recipe reference](#recipe-reference)
+  - [Customizing this template](#customizing-this-template)
+    - [C++ library](#c-library)
+    - [C++ bindings](#c-bindings)
+    - [C++ tests](#c-tests)
+    - [Python package](#python-package)
 
 ## Project structure
 

From 0f534841af4e3bc523c6caacbc557e035bf93137 Mon Sep 17 00:00:00 2001
From: sreea05 <258596614+sreea05@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:10:37 +0100
Subject: [PATCH 2/2] README: Fix project tree

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1aee471..3457a88 100644
--- a/README.md
+++ b/README.md
@@ -85,7 +85,8 @@ A **template** C++ library exposed to Python via [pybind11](https://github.com/p
     │   └── api.rst
     ├── src/
     │   └── core_lib/
-    │       └── __init__.py     # Re-exports from _core
+    │       ├── __init__.py     # Re-exports from _core
+    │       └── math.py
     └── tests/
         ├── unit/
         │   └── test_core_lib.py        # Unit tests (individual functions)