From 959ea0df6056a8489e1bad1109b3f2575eae9602 Mon Sep 17 00:00:00 2001
From: Michael Szell <michael@szell.net>
Date: Sun, 9 Aug 2026 12:33:13 +0200
Subject: [PATCH 1/2] Add logo and when to use to readme

---
 README.md                               |   7 ++++++-
 docs/source/_static/logo_fixbikenet.png | Bin 0 -> 10822 bytes
 2 files changed, 6 insertions(+), 1 deletion(-)
 create mode 100644 docs/source/_static/logo_fixbikenet.png

diff --git a/README.md b/README.md
index 6a5d4c9..e2f16c7 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Bike Net Kit / Fix Bike Net
+# <a href="https://docs.bikenetkit.org/FixBikeNet/"><img src="docs/source/_static/logo_fixbikenet.png" alt="FixBikeNet" width="400"></a>
 
 [![PyPI Version](https://img.shields.io/pypi/v/fixbikenet?color=10d249)](https://pypi.org/project/FixBikeNet/)
 [![Docs](https://github.com/BikeNetKit/FixBikeNet/actions/workflows/docs.yml/badge.svg)](https://bikenetkit.github.io/FixBikeNet/)
@@ -9,6 +9,11 @@ The Python package `fixbikenet` identifies the most important gaps to fill in a
 
 FixBikeNet is a decision support tool for urban planners. It is also useful for proactive citizens to help inform their city about data-driven improvements, and it aims to foster research on bicycle networks.
 
+## When to use
+FixBikeNet works well for cities or areas that have a well developed -but not yet perfect- bicycle network. Recommended example cities to fix: Aalborg, Amsterdam, Copenhagen
+
+For alternative approaches, or for cities with less developed bicycle networks, consider using [LinkBikeNet](https://github.com/BikeNetKit/LinkBikeNet) or extending the existing network with [GrowBikeNet](https://github.com/BikeNetKit/GrowBikeNet).
+
 ## Installation
 
 ### The easy way
diff --git a/docs/source/_static/logo_fixbikenet.png b/docs/source/_static/logo_fixbikenet.png
new file mode 100644
index 0000000000000000000000000000000000000000..9606c18643e77cd9256a2073b6814cb7476fec23
GIT binary patch
literal 10822
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
Ubli4~AHJZ;ORIp2-<bscKb-6bG5`Po

literal 0
HcmV?d00001


From f4b0ec95e907f13869f304c98fee592f45b070c7 Mon Sep 17 00:00:00 2001
From: Michael Szell <michael@szell.net>
Date: Sun, 9 Aug 2026 12:42:37 +0200
Subject: [PATCH 2/2] Add logo to docs, make conf consistent with gbn

---
 README.md                               |   2 +-
 docs/source/_static/favicon.png         | Bin 0 -> 455 bytes
 docs/source/_static/logo_fixbikenet.svg |   6 ++++++
 docs/source/conf.py                     |  13 ++++++++-----
 docs/source/index.rst                   |  17 ++++++++++++++---
 5 files changed, 29 insertions(+), 9 deletions(-)
 create mode 100644 docs/source/_static/favicon.png
 create mode 100644 docs/source/_static/logo_fixbikenet.svg

diff --git a/README.md b/README.md
index e2f16c7..bfb7ccd 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# <a href="https://docs.bikenetkit.org/FixBikeNet/"><img src="docs/source/_static/logo_fixbikenet.png" alt="FixBikeNet" width="400"></a>
+# <a href="https://docs.bikenetkit.org/FixBikeNet/"><img src="docs/source/_static/logo_fixbikenet.svg" alt="FixBikeNet" width="400"></a>
 
 [![PyPI Version](https://img.shields.io/pypi/v/fixbikenet?color=10d249)](https://pypi.org/project/FixBikeNet/)
 [![Docs](https://github.com/BikeNetKit/FixBikeNet/actions/workflows/docs.yml/badge.svg)](https://bikenetkit.github.io/FixBikeNet/)
diff --git a/docs/source/_static/favicon.png b/docs/source/_static/favicon.png
new file mode 100644
index 0000000000000000000000000000000000000000..064924ca517f1d67fdfb1d6106c0eb5eb325463b
GIT binary patch
literal 455
zcmeAS@N?(olHy`uVBq!ia0vp^3LwnE3?yBabR7dymH|E?uI>dsw%6rtuFGOUH?Rr9
zROWr&{}yP7P)U$qFax{Lq_q97zFW(=mfTx1f1PgVT2ZwI1_nlLPZ!4!i{7ch7yFJV
zaD-%wMwj3H^k2SOiKA+EOws26Ya^}~FYeR_D6CoXhs$14P}rc;#bDh>X36AFx=(UH
zuD*OLBQ|kT)T{UaM^~F)1xov#UEeF<FIr;CD`%)(*t}waU*bgvv4t!v++RHQWqh^q
zi<gRwW<1;ffS2l5C+OFg#y+lakiYOC?{DvC9=<43#$|ffm}Wd!u#A04i^VrDtrN2z
zr#VX9%80I+^XG@)^RowMK6ootWX~KEcUgK<*AKNnbN<Xw@VdpQt+86c^I??I!d0qi
zu1UIcc}@q;dHi7;&y>R~5jJdZ9rd0)sgvWM$z#l$8Gf3b<MAgm<r$Wzc&^;lG)uF*
zTiSkhLDJ=9sR;>U`*%FQqcyqn?ZhKfeR@vn#5zWGBvr3?`1<O<PWf5xil;B_U_J^A
OR0dC1KbLh*2~7Z&=f4F2

literal 0
HcmV?d00001

diff --git a/docs/source/_static/logo_fixbikenet.svg b/docs/source/_static/logo_fixbikenet.svg
new file mode 100644
index 0000000..1bd1de6
--- /dev/null
+++ b/docs/source/_static/logo_fixbikenet.svg
@@ -0,0 +1,6 @@
+<svg width="254.65" height="59" viewBox="0 0 254.65 59" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M52.6558 0C59.4755 0 64.0001 5.04574 64.0001 11.3365C64.0001 17.6273 59.5903 27.8157 52.6558 43.3803C45.7213 27.8157 41.3115 17.6273 41.3115 11.3365C41.3115 5.04574 45.8361 0 52.6558 0ZM52.6558 5.96315C49.6861 5.96315 47.2787 8.3689 47.2787 11.3365C47.2787 14.3042 49.6861 16.7099 52.6558 16.7099C55.6255 16.7099 58.0328 14.3042 58.0328 11.3365C58.0328 8.3689 55.6255 5.96315 52.6558 5.96315Z" fill="#269210"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M25.6394 0C30.9573 0 35.4199 3.65699 36.648 8.59153C41.2816 25.7989 41.3649 26.033 48.6353 42.3054C49.3211 43.7657 49.705 45.3956 49.705 47.1155C49.705 53.3764 44.626 58.452 38.3608 58.452C33.0427 58.452 28.5802 54.7949 27.352 49.8603C22.7186 32.653 22.6352 32.4189 15.3648 16.1466C14.6791 14.6863 14.2952 13.089 14.2952 11.3693C14.2952 5.10825 19.3741 0 25.6394 0ZM38.3607 41.7421C35.3911 41.7421 32.9837 44.1478 32.9837 47.1154C32.9837 50.0831 35.3911 52.4888 38.3607 52.4888C41.3304 52.4888 43.7378 50.0831 43.7378 47.1154C43.7378 44.1478 41.3304 41.7421 38.3607 41.7421ZM25.6394 5.96314C22.6698 5.96314 20.2624 8.36889 20.2624 11.3365C20.2624 14.3042 22.6698 16.7099 25.6394 16.7099C28.6091 16.7099 31.0165 14.3042 31.0165 11.3365C31.0165 8.36889 28.6091 5.96314 25.6394 5.96314Z" fill="#3CD71D"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M11.3442 58.452C4.52453 58.452 -6.29425e-05 53.4063 -6.29425e-05 47.1155C-6.29425e-05 40.8247 4.40968 30.6363 11.3442 15.0717C18.2787 30.6363 22.6885 40.8247 22.6885 47.1155C22.6885 53.4063 18.1639 58.452 11.3442 58.452ZM11.3442 52.4889C14.3139 52.4889 16.7213 50.0831 16.7213 47.1155C16.7213 44.1478 14.3139 41.7421 11.3442 41.7421C8.37454 41.7421 5.96715 44.1478 5.96715 47.1155C5.96715 50.0831 8.37454 52.4889 11.3442 52.4889Z" fill="#39BF1E"/>
+<path d="M81.592 43.64L76.28 43.64L80.216 21.24L93.656 21.24L92.664 25.464L84.792 25.464L83.896 30.552L91.384 30.552L90.68 34.584L83.192 34.584L81.592 43.64M99.64 24.92L99.64 24.92Q98.456 24.92 97.64 24.232Q96.824 23.544 96.824 22.392L96.824 22.392Q96.824 21.144 97.736 20.264Q98.648 19.384 100.024 19.384L100.024 19.384Q101.176 19.384 101.976 20.088Q102.776 20.792 102.776 21.944L102.776 21.944Q102.776 23.192 101.88 24.056Q100.984 24.92 99.64 24.92M101.56 26.584L98.552 43.64L93.368 43.64L96.216 27.576L101.56 26.584M109.88 39.096L109.336 38.712Q107.576 40.504 106.36 43.64L106.36 43.64L101.72 43.64Q103.16 39.32 107.096 35.736L107.096 35.736L107.928 35.032L104.248 27.448L109.304 26.584L111.896 31.96Q112.344 31.576 112.76 31.032L112.76 31.032Q114.264 29.336 114.808 26.968L114.808 26.968L119.544 26.968Q118.776 30.424 114.584 34.488L114.584 34.488L113.592 35.448L117.56 43.64L112.088 43.64L109.88 39.096M131.348 43.992L131.348 43.992Q128.916 43.992 124.5 43.416L124.5 43.416L128.34 21.336Q131.796 20.888 134.004 20.888L134.004 20.888Q138.292 20.888 140.564 22.408Q142.836 23.928 142.836 26.68L142.836 26.68Q142.836 28.696 141.652 30.216Q140.468 31.736 138.42 32.376L138.42 32.376L138.388 32.472Q141.94 33.4 141.94 36.888L141.94 36.888Q141.94 39.256 140.484 40.888Q139.028 42.52 136.692 43.256Q134.356 43.992 131.348 43.992M133.044 24.76L132.02 30.712L134.196 30.712Q135.668 30.712 136.564 29.768Q137.46 28.824 137.46 27.32L137.46 27.32Q137.46 24.76 134.772 24.76L134.772 24.76L133.044 24.76M131.444 33.976L130.356 40.088L132.628 40.088Q134.356 40.088 135.428 39.24Q136.5 38.392 136.5 36.888L136.5 36.888Q136.5 35.576 135.636 34.776Q134.772 33.976 133.3 33.976L133.3 33.976L131.444 33.976M150.644 24.92L150.644 24.92Q149.46 24.92 148.644 24.232Q147.828 23.544 147.828 22.392L147.828 22.392Q147.828 21.144 148.74 20.264Q149.652 19.384 151.028 19.384L151.028 19.384Q152.18 19.384 152.98 20.088Q153.78 20.792 153.78 21.944L153.78 21.944Q153.78 23.192 152.884 24.056Q151.988 24.92 150.644 24.92M152.564 26.584L149.556 43.64L144.372 43.64L147.22 27.576L152.564 26.584M166.836 26.968L172.02 26.968Q171.412 29.528 167.828 33.464L167.828 33.464L166.164 35.16L170.164 43.64L164.468 43.64L160.916 35.544L159.476 43.64L154.292 43.64L158.42 20.248L163.764 19.256L161.044 34.776L163.092 32.504Q166.004 29.176 166.836 26.968L166.836 26.968M185.748 39.544L186.036 42.936Q183.316 43.992 180.884 44.024L180.884 44.024Q180.212 44.024 179.892 43.992L179.892 43.992Q176.436 43.8 174.468 41.752Q172.5 39.704 172.5 36.472L172.5 36.472Q172.5 32.376 175.044 29.528Q177.588 26.68 181.332 26.584L181.332 26.584Q181.94 26.584 182.26 26.616L182.26 26.616Q184.628 26.808 186.084 28.248Q187.54 29.688 187.732 31.864L187.732 31.864Q187.764 32.152 187.764 32.696L187.764 32.696Q187.7 33.944 187.284 35L187.284 35Q183.732 36.28 177.716 37.176L177.716 37.176Q177.94 37.56 178.004 37.624L178.004 37.624Q178.804 40.248 181.78 40.248L181.78 40.248Q181.812 40.248 181.876 40.232Q181.94 40.216 181.972 40.216L181.972 40.216Q183.444 40.184 185.748 39.544L185.748 39.544M181.364 30.072L181.364 30.072Q180.116 30.072 179.012 31.272Q177.908 32.472 177.524 34.264L177.524 34.264Q180.724 33.72 183.22 32.952L183.22 32.952Q183.284 31.64 182.82 30.856Q182.356 30.072 181.364 30.072M212.912 43.64L208.4 43.64L201.04 29.432L198.544 43.64L193.744 43.64L197.68 21.24L201.84 21.24L209.456 36.024L212.048 21.24L216.848 21.24L212.912 43.64M231.344 39.544L231.632 42.936Q228.912 43.992 226.48 44.024L226.48 44.024Q225.808 44.024 225.488 43.992L225.488 43.992Q222.032 43.8 220.064 41.752Q218.096 39.704 218.096 36.472L218.096 36.472Q218.096 32.376 220.64 29.528Q223.184 26.68 226.928 26.584L226.928 26.584Q227.536 26.584 227.856 26.616L227.856 26.616Q230.224 26.808 231.68 28.248Q233.136 29.688 233.328 31.864L233.328 31.864Q233.36 32.152 233.36 32.696L233.36 32.696Q233.296 33.944 232.88 35L232.88 35Q229.328 36.28 223.312 37.176L223.312 37.176Q223.536 37.56 223.6 37.624L223.6 37.624Q224.4 40.248 227.376 40.248L227.376 40.248Q227.408 40.248 227.472 40.232Q227.536 40.216 227.568 40.216L227.568 40.216Q229.04 40.184 231.344 39.544L231.344 39.544M226.96 30.072L226.96 30.072Q225.712 30.072 224.608 31.272Q223.504 32.472 223.12 34.264L223.12 34.264Q226.32 33.72 228.816 32.952L228.816 32.952Q228.88 31.64 228.416 30.856Q227.952 30.072 226.96 30.072M245.488 39.704L245.232 43.224Q243.44 44.024 241.296 44.024L241.296 44.024Q238.672 44.024 237.36 42.296Q236.048 40.568 236.56 37.72L236.56 37.72L237.808 30.616L235.536 30.616L236.08 27.384L238.544 27.288L239.856 23L244.496 22.104L243.632 27.096L247.856 26.936L247.216 30.616L242.992 30.616L241.84 37.144Q241.392 39.864 243.664 39.864L243.664 39.864Q244.432 39.864 245.488 39.704L245.488 39.704" fill="#096a51"/>
+</svg>
diff --git a/docs/source/conf.py b/docs/source/conf.py
index ce0e6fb..a3b374f 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -61,12 +61,15 @@
 ### select html theme
 html_theme = "furo"
 
+html_logo = "_static/logo_fixbikenet.svg"
+html_favicon = "_static/favicon.png"
 html_theme_options = {
-    "pygment_light_style": "tango",
-    "logo": {
-        "image_light": "logo.png",
-        "image_dark": "logo.png",
-    },
+    "sidebar_hide_name": True,
+    "source_repository": "https://github.com/BikeNetKit/FixBikeNet/",
+    "source_branch": "main",
+    "source_directory": "docs/source/",
+    "top_of_page_buttons": ["view", "edit"],
+    "navigation_with_keys": True,
     "light_css_variables": {
         "color-brand-primary": "#096a51",
         "color-brand-content": "#096a51",
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 2b000cd..d3258a1 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -6,11 +6,16 @@
 FixBikeNet |version| documentation
 ===================================
 
-The Python package ``fixbikenet`` identifies the most important gaps to fill in a city's bicycle network. It is hosted on `Github <https://github.com/BikeNetKit/FixBikeNet>`__, part of `BikeNetKit <https://bikenetkit.org>`__.
+The Python package ``fixbikenet`` identifies the most important gaps to fill in a city's bicycle network. You can download street and bike network data with a single line of code, simulate different bicycle network fixing scenarios, and export and plot the resulting prioritized gaps. It is hosted on `Github <https://github.com/BikeNetKit/FixBikeNet>`__, part of `BikeNetKit <https://bikenetkit.org>`__.
 
-The software downloads and pre-processes data from OpenStreetMap, identifies the gaps, saves the results, creates plots and videos. The source code builds on `the code from the
-research paper <https://github.com/anastassiavybornova/bikenwgaps>`__ *Automated Detection of Missing Links in Bicycle Networks*.
+FixBikeNet is a decision support tool for urban planners. It is also useful for proactive citizens to help inform their city about data-driven improvements, and it aims to foster research on bicycle networks.
+
+When to use
+-----------
+
+FixBikeNet works well for cities or areas that have a well developed -but not yet perfect- bicycle network. Recommended example cities to fix: Aalborg, Amsterdam, Copenhagen
 
+For alternative approaches, or for cities with less developed bicycle networks, consider using `LinkBikeNet <https://github.com/BikeNetKit/LinkBikeNet>`__ or extending the existing network with `GrowBikeNet <https://github.com/BikeNetKit/GrowBikeNet>`__.
 
 Setup and use
 -------------
@@ -24,6 +29,12 @@ is a good place to start, which also explains how the package works in detail. F
 
 .. TBA
 
+Source
+------
+
+The source code builds on `the code from the
+research paper <https://github.com/anastassiavybornova/bikenwgaps>`__ *Automated Detection of Missing Links in Bicycle Networks*.
+
 How to cite
 -----------