From 443d961f2295cabd2722bcf10a08e108b8595d65 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Carlson=20B=C3=BCth?= <commit@cbueth.de>
Date: Fri, 13 Mar 2026 17:54:04 +0100
Subject: [PATCH] docs: Add Master Thesis link and references

---
 README.md      | 7 ++++++-
 docs/index.rst | 8 ++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b3d4078..ff4465e 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,7 @@
 [![linting: pylint](https://img.shields.io/badge/linting-pylint-yellowgreen)](https://github.com/PyCQA/pylint)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![PyPI License](https://img.shields.io/pypi/l/superblockify)](https://pypi.org/project/superblockify/)
+[![Master Thesis](https://img.shields.io/badge/Master_Thesis-PDF-purple)](https://cbueth.de/assets/pdf/cbueth_MA_Superblockify.pdf)
 
 [![status](https://joss.theoj.org/papers/87426e988ebd0a6d7f592eb16d1fd209/status.svg)](https://joss.theoj.org/papers/87426e988ebd0a6d7f592eb16d1fd209)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13300610.svg)](https://doi.org/10.5281/zenodo.13300610)
@@ -100,4 +101,8 @@ see [`.github/workflows/test.yml`](https://github.com/NERDSITU/superblockify/blo
 * Michael Szell, [@mszell](https://github.com/mszell) (Concept)
 
 Funded by the European
-Union, [EU Horizon grant JUST STREETS](https://cordis.europa.eu/project/id/101104240)
\ No newline at end of file
+Union, [EU Horizon grant JUST STREETS](https://cordis.europa.eu/project/id/101104240)
+
+## More Information
+
+* [Master Thesis (PDF)](https://cbueth.de/assets/pdf/cbueth_MA_Superblockify.pdf) - Detailed background, methodology, and evaluation
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index 5bd08bc..f01d35c 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -20,6 +20,9 @@
      <a href="https://pypi.org/project/superblockify/" style="margin: 0 10px; display: inline-block;">
        <img src="https://img.shields.io/pypi/l/superblockify" alt="License" />
      </a>
+     <a href="https://cbueth.de/assets/pdf/cbueth_MA_Superblockify.pdf" style="margin: 0 10px; display: inline-block;">
+       <img src="https://img.shields.io/badge/Master_Thesis-PDF-purple" alt="Master Thesis" />
+     </a>
    </div>
    <div style="height: 10px;"></div>
 
@@ -63,6 +66,11 @@ JOSS paper `doi:10.21105/joss.06798 <https://doi.org/10.21105/joss.06798>`__, e.
 
     Büth et al., (2024). superblockify: A Python Package for Automated Generation, Visualization, and Analysis of Potential Superblocks in Cities. Journal of Open Source Software, 9(100), 6798, https://doi.org/10.21105/joss.06798
 
+Further reading
+===============
+For more detailed background, methodology, and evaluation, see the
+`Master Thesis (PDF) <https://cbueth.de/assets/pdf/cbueth_MA_Superblockify.pdf>`__.
+
 Contributing
 ============
 If you want to contribute to the development of superblockify, please read the