From cad14d286a4330f079247150116ef359f0dd52df Mon Sep 17 00:00:00 2001
From: Hel Gibbons <hel@pimoroni.com>
Date: Thu, 20 Jun 2024 13:12:59 +0100
Subject: [PATCH 1/2] Update README.md

---
 README.md | 62 +++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 49 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 4459d0c..3ba43d5 100644
--- a/README.md
+++ b/README.md
@@ -7,26 +7,62 @@
 
 Generated from [the Pimoroni Python Boilerplate](https://github.com/pimoroni/boilerplate-python).
 
-# Pre-requisites
+product description goes here
 
-You must enable (delete where appropriate):
+## Where to buy
 
-* i2c: `sudo raspi-config nonint do_i2c 0`
-* spi: `sudo raspi-config nonint do_spi 0`
-
-You can optionally run `sudo raspi-config` or the graphical Raspberry Pi Configuration UI to enable interfaces.
+* [link goes here](link goes here)
 
 # Installing
 
-Stable library from PyPi:
+## Full install (recommended):
+
+We've created an easy installation script that will install all pre-requisites and get you up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal
+on your Raspberry Pi desktop, as illustrated below:
+
+![Finding the terminal](http://get.pimoroni.com/resources/github-repo-terminal.png)
+
+In the new terminal window type the commands exactly as it appears below (check for typos) and follow the on-screen instructions:
+
+```bash
+git clone https://github.com/pimoroni/PROJECT_NAME-python
+cd PROJECT_NAME-python
+./install.sh
+```
+
+**Note** Libraries will be installed in the "pimoroni" virtual environment, you will need to activate it to run examples:
+
+```
+source ~/.virtualenvs/pimoroni/bin/activate
+```
 
-* Just run `pip3 install PROJECT_NAME`
+## Development:
 
-In some cases you may need to use `sudo` or install pip with: `sudo apt install python3-pip`
+If you want to contribute, or like living on the edge of your seat by having the latest code, you can install the development version like so:
 
-Latest/development library from GitHub:
+```bash
+git clone https://github.com/pimoroni/PROJECT_NAME-python
+cd PROJECT_NAME-python
+./install.sh --unstable
+```
+
+## Install stable library from PyPi and configure manually
+
+* Set up a virtual environment: `python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni`
+* Switch to the virtual environment: `source ~/.virtualenvs/pimoroni/bin/activate`
+* Install the library: `pip install PROJECT_NAME`
+
+In some cases you may need to us `sudo` or install pip with: `sudo apt install python3-pip`.
+
+This will not make any configuration changes, so you may also need to enable:
+
+* i2c: `sudo raspi-config nonint do_i2c 0`
+* spi: `sudo raspi-config nonint do_spi 0`
+
+You can optionally run `sudo raspi-config` or the graphical Raspberry Pi Configuration UI to enable interfaces.
 
-* `git clone https://github.com/pimoroni/PROJECT_NAME-python`
-* `cd PROJECT_NAME-python`
-* `./install.sh --unstable`
+Some of the examples have additional dependencies. You can install them with:
 
+```bash
+pip install
+```
\ No newline at end of file

From 038313b3142f1b5065aaa990486633ca087eddad Mon Sep 17 00:00:00 2001
From: Hel Gibbons <hel@pimoroni.com>
Date: Fri, 21 Jun 2024 12:12:00 +0100
Subject: [PATCH 2/2] =?UTF-8?q?readme:=20require=20Python=20=E2=89=A53.7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/README.md b/README.md
index 3ba43d5..140eee7 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,8 @@ product description goes here
 
 # Installing
 
+We'd recommend using this library with Raspberry Pi OS Bookworm or later. It requires Python ≥3.7.
+
 ## Full install (recommended):
 
 We've created an easy installation script that will install all pre-requisites and get you up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal