Add customization

Author: daavoo

docs/authorization.md

@@ -5,10 +5,11 @@ accounts you need to set up.
 
 ## `MAPBOX_TOKEN`
 
-Used to download the satellite images for both [creating a dataset](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/create_dataset.ipynb) and [running inference](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/run_inference.ipynb).
+Used to download the satellite images when [creating a dataset](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/create_dataset.ipynb) and/or [running inference](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/run_inference.ipynb).
+
 You need to:
 
-- Createa an account: https://console.mapbox.com/ 
+- Create an account: https://console.mapbox.com/
 - Follow this guide to obtain your [Default Public Token](https://docs.mapbox.com/help/getting-started/access-tokens/#your-default-public-token).
 
 ## `OSM_CLIENT_ID` and `OSM_CLIENT_SECRET`
@@ -22,3 +23,12 @@ You need to:
     Grant `Modify the map (write_api)`.
     Set the redirect URL to `https://127.0.0.1:8000`.
 - Copy and save the `Client ID` and `Client Secret`.
+
+## `HF_TOKEN`
+
+Only needed if you are [Creating a Dataset](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/create_dataset.ipynb) and/or [Finetuning a Model](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/finetune_model.ipynb) in order to upload the results to the [HuggingFace Hub](https://huggingface.co/docs/hub/index).
+
+You need to:
+
+- Create an account: https://huggingface.co/join
+- Follow this guide about [`User Access Tokens`](https://huggingface.co/docs/hub/security-tokens)

docs/customization.md

@@ -1,21 +1,23 @@
 # 🎨 **Customization Guide**
 
-This Blueprint is designed to be flexible and easily adaptable to your specific needs. This guide will walk you through some key areas you can customize to make the Blueprint your own.
+This OpenStreetMap AI Helper Blueprint is designed to be flexible and easily adaptable to your specific needs. This guide will walk you through some key areas you can customize to make the Blueprint your own.
 
 ---
 
 ## 🧠 **Changing the Model**
 
+The default provided model is trained to detect swimming pools.
 
+You can follow the [Create Dataset](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/create_dataset.ipynb) and [Finetune Model](https://colab.research.google.com/github/mozilla-ai/osm-ai-helper/blob/main/demo/finetune_model.ipynb).
 
-## 📝 **Modifying the system Prompt**
-
-
-
-## 💡 Other Customization Ideas
-
-- other ideas..
+When creating the dataset, you need to pick:
 
+- A `selector` based on [OpenStreetMap tags](https://wiki.openstreetmap.org/wiki/Map_features).
+    The example uses [`leisure=swimming_pool`](https://wiki.openstreetmap.org/wiki/Tag:leisure=swimming_pool).
+    Try to pick elements that can be clearly delimited with a polygon and are easy to distinguish in the satellite images.
+    A similar example would be a tenis court `leisure=pitch + sport=tennis`.
+- An appropriate [`zoom` level](https://docs.mapbox.com/help/glossary/zoom-level/) (the example uses `18`).
+    There is a tradeoff between easier detection (higher zoom levels) and covering a wider area on each tile (lower zoom levels).
 
 ## 🤝 **Contributing to the Blueprint**
 

docs/future-features-contributions.md

@@ -15,11 +15,12 @@ This Blueprint is an evolving project designed to grow with the help of the open
 
 This Blueprint is designed to be a foundation you can build upon. By extending its capabilities, you can open the door to new applications, improve user experience, and adapt the Blueprint to address other use cases. Here are a few ideas for how you can expand its potential:
 
-
-We’d love to see how you can enhance this Blueprint! If you create improvements or extend its capabilities, consider contributing them back to the project so others in the community can benefit from your work. Check out our [Contributions Guide](https://github.com/mozilla-ai/osm-ai-helper/blob/main/CONTRIBUTING.md) to get started!
+We'd love to see how you can enhance this Blueprint! If you create improvements or extend its capabilities, consider contributing them back to the project so others in the community can benefit from your work. Check out our [Contributions Guide](https://github.com/mozilla-ai/osm-ai-helper/blob/main/CONTRIBUTING.md) to get started!
 
 ### 💡 **Share Your Ideas**
-Got an idea for how this Blueprint could be improved? You can share your suggestions through [GitHub Discussions](https://github.com/mozilla-ai/osm-ai-helper/discussions).
+Got an idea for how this Blueprint could be improved? You can share your suggestions in Discord:
+
+<a target="_blank" href="https://discord.gg/gazz5XDU"><img src="https://dcbadge.limes.pink/api/server/gazz5XDU" alt="" /></a>
 
 ### 🌍 **Build New Blueprints**
 This project is part of a larger initiative to create a collection of reusable starter code solutions that use open-source AI tools. If you’re inspired to create your own Blueprint, you can use the [blueprint-template](https://github.com/new?template_name=blueprint-template&template_owner=mozilla-ai) to get started.