diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f750d68..f0e01fb 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -2,36 +2,34 @@
 
 ## Overview
 
-This documents explains the processes and practices recommended for contributing enhancements to
-this snap.
-
-- Generally, before developing enhancements to this snap, you should consider [opening an issue
-  ](https://github.com/openstack-snaps/snap-microstack-hypervisor/issues) explaining your use case.
-- If you would like to chat with us about your use-cases or proposed implementation, you can reach
-  us at [Canonical Mattermost public channel](https://chat.charmhub.io/charmhub/channels/charm-dev)
-  or [Discourse](https://discourse.charmhub.io/).
-- Familiarising yourself with [Snaps and Snapcraft](https://snapcraft.io/docs) documentation
-  will help you a lot when working on new features or bug fixes.
+This document explains the processes and practices recommended for contributing enhancements to the OpenStack Hypervisor snap.
+
+- Before contributing, you should consider [opening an issue in Launchpad](https://bugs.launchpad.net/snap-openstack-hypervisor) explaining your use case.
+- If you would like to chat with us about your use-cases or proposed implementation, you can reach us at the [OpenStack Sunbeam community chat](https://matrix.to/#/#openstack-sunbeam:ubuntu.com).
+- Familiarize yourself with [Snaps and Snapcraft](https://snapcraft.io/docs) documentation will help you a lot when working on new features or bug fixes.
 - All enhancements require review before being merged. Code review typically examines
   - code quality
   - test coverage
-- Please help us out in ensuring easy to review branches by rebasing your pull request branch onto
-  the `main` branch. This also avoids merge commits and creates a linear Git commit history.
+- Please help us out in ensuring easy to review branches by rebasing your pull request branch onto the `main` branch. This also avoids merge commits and creates a linear Git commit history.
+
+## Reporting a bug
+
+Please report bugs to the [OpenStack Snap](https://bugs.launchpad.net/snap-openstack-hypervisor) project on Launchpad.
 
 ## Developing
 
-You can use the environments created by `tox` for development:
+The project uses [uv](https://docs.astral.sh/uv/) for dependency management. Create and activate a development environment with the dev extras:
 
 ```shell
-tox --notest -e unit
-source .tox/unit/bin/activate
+uv sync --extra dev
+source .venv/bin/activate
 ```
 
 ### Testing
 
 ```shell
-tox -e fmt           # update your code according to linting rules
-tox -e lint          # code style
+tox -e fmt           # format your code (isort + black)
+tox -e lint          # code style (flake8, isort, black, codespell)
 tox -e unit          # unit tests
 tox                  # runs 'lint' and 'unit' environments
 ```
@@ -41,22 +39,36 @@ tox                  # runs 'lint' and 'unit' environments
 Build the snap in this git repository using:
 
 ```shell
-snapcraft --use-lxd
+snapcraft clean --use-lxd && snapcraft --use-lxd
 ```
 
-### Deploy
+### Deploy a locally built snap
+
+For testing a local change, you may wish to build and deploy the snap yourself. Install the locally built snap in dangerous mode (required because it is an unsigned package). However, snap interfaces installed in dangerous mode will not be automatically connected. The easiest way to connect the snap is to first install from the snap store, then install the local snap in dangerous mode. This will ensure that all the required interfaces are connected.
 
 ```bash
-# Install the development snap
-sudo snap install --devmode
-# Configure 
-sudo snap set mysqld-exporter mysql.host=localhost mysql.user=testuser mysql.password=secret123
-# Restart the service for the changes to take effect
-sudo snap restart microstack-hypervisor
+sudo snap install openstack-hypervisor --channel <existing-channel>
+sudo snap install --dangerous openstack-hypervisor_*.snap
 ```
 
+
+
+Alternatively, use [`snap try`](https://snapcraft.io/docs/snap-try) to install from an unpacked directory, which is useful if you want to make further changes and test them without rebuilding the snap:
+
+```bash
+unsquashfs openstack-hypervisor_*.snap
+sudo snap try ./squashfs-root
+```
+
+After applying changes, restart the snap:
+
+```bash
+# Restart the services for the changes to take effect
+sudo snap restart openstack-hypervisor
+```
+
+See the [Configuration Reference](README.md#configuration-reference) section of the README for the full set of configuration options.
+
 ## Canonical Contributor Agreement
 
-Canonical welcomes contributions to the MicroStack Hypervisor snap. Please check
-out our [contributor agreement](https://ubuntu.com/legal/contributors) if you're
-interested in contributing to the solution.
\ No newline at end of file
+Canonical welcomes contributions to the OpenStack Hypervisor snap. Please check out our [contributor agreement](https://ubuntu.com/legal/contributors) if you're interested in contributing to the solution.