diff --git a/readme.md b/readme.md
index 838bfc4d..bd0bc5b7 100644
--- a/readme.md
+++ b/readme.md
@@ -4,13 +4,17 @@
 My personal dotfiles repo. Documentation is pretty spotty. Maybe I'll fix that 
 someday, but I probably won't. 
 
-| <img src="./img/kestrel.png" width="100"> | Primary desktop. |
-|---|---|
-| <img src="./img/torus.png" width="100"> | Home server. |
-| <img src="./img/bulwark.png" width="100"> | Steam Deck. |
-
 ## Usage
 
-Dotfiles are managed with chezmoi and located in the `home` folder. Ansible 
-scripts for installing and configuring various linux distrobutions are located 
-in the `provision` folder
+Dotfiles are managed with chezmoi and located in the `home` folder. The NixOS 
+flake contained in `provision` contains nix code for installing and configuring 
+my various NixOS based machines. See the provision [readme](./provision/readme.md)
+for information on initial installation.
+
+## Managed Machines
+
+| | Name | Role | Description |
+|---|---|---|---|
+| <img src="./img/kestrel.png" width="100"> | [Kestrel](./provision/hosts/kestrel/) | Primary desktop | Main machine that does it all gaming, programming, 3D modelling, etc. |
+| <img src="./img/torus.png" width="100"> | [Torus](./provision/hosts/torus/) | Home server | Primary home server for storage, hosting machine backups, and running services like Jellyfin. |
+| <img src="./img/bulwark.png" width="100"> | [Bulwark](./provision/hosts/bulwark/) | Steam Deck | NixOS based Steam Deck that can has my linux niceties and acts like a Steam Deck using the great [Jovian Nixos](https://github.com/Jovian-Experiments/Jovian-NixOS). |