From 277d1ba381ef47207b448ba5c8ea118f26290450 Mon Sep 17 00:00:00 2001
From: Hel Gibbons <50950368+helgibbons@users.noreply.github.com>
Date: Wed, 12 Nov 2025 13:28:15 +0000
Subject: [PATCH 1/3] README.md - Update installation instructions

---
 README.md | 51 ++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 40 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index af65d59..940db28 100644
--- a/README.md
+++ b/README.md
@@ -7,23 +7,52 @@
 
 Suitable for measuring ambient temperature, barometric pressure, and humidity, the BME280 is a great indoor environmental sensor.
 
-# Pre-requisites
+## Installing
 
-You must enable:
+We'd recommend using this library with Raspberry Pi OS Bookworm or later. It requires Python ≥3.7.
 
-* i2c: `sudo raspi-config nonint do_i2c 0`
+## Full install (recommended):
 
-You can optionally run `sudo raspi-config` or the graphical Raspberry Pi Configuration UI to enable interfaces.
+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/bme280-python
+cd lsm6ds3-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
+```
 
-# Installing
+## Development:
 
-Stable library from PyPi, the smbus library is also needed:
+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:
 
-* Just run `python3 -m pip install pimoroni-bme280`
+```bash
+git clone https://github.com/pimoroni/bme280-python
+cd lsm6ds3-python
+./install.sh --unstable
+```
 
-Latest/development library from GitHub:
+## Install stable library from PyPi and configure manually
 
-* `git clone https://github.com/pimoroni/bme280-python`
-* `cd bme280-python`
-* `sudo ./install.sh`
+* 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 pimoroni-bme280`
+
+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`
+
+You can optionally run `sudo raspi-config` or the graphical Raspberry Pi Configuration UI to enable interfaces.
 

From 8cdbf4d188311b3a2bd27c983666d819fff62940 Mon Sep 17 00:00:00 2001
From: Hel Gibbons <50950368+helgibbons@users.noreply.github.com>
Date: Wed, 12 Nov 2025 13:30:36 +0000
Subject: [PATCH 2/3] README.md - update installation instructions

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

diff --git a/README.md b/README.md
index 940db28..22582c6 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@ If you want to contribute, or like living on the edge of your seat by having the
 
 ```bash
 git clone https://github.com/pimoroni/bme280-python
-cd lsm6ds3-python
+cd bme280-python
 ./install.sh --unstable
 ```
 

From ba90c018e23b1b0bcbc80e2a4539087d88e8a3dc Mon Sep 17 00:00:00 2001
From: Hel Gibbons <50950368+helgibbons@users.noreply.github.com>
Date: Wed, 12 Nov 2025 13:31:44 +0000
Subject: [PATCH 3/3] README.md: update installation instructions

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

diff --git a/README.md b/README.md
index 22582c6..aba5a23 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@ In the new terminal window type the commands exactly as it appears below (check
 
 ```bash
 git clone https://github.com/pimoroni/bme280-python
-cd lsm6ds3-python
+cd bme280-python
 ./install.sh
 ```