diff --git a/readme.md b/readme.md
index e4e6ad0..0983c3d 100644
--- a/readme.md
+++ b/readme.md
@@ -1,32 +1,42 @@
-Treefile → apt-ostree → Container Image → Registry Upload → bootc-image-builder → debian-forge(osbuild) → Bootable Disk Image
+# Notes about OSTREE operating systems
 
-https://ostreedev.github.io/ostree/
+## Fedora Atomic
+Treefile → rpm-ostree → Container Image → Registry Upload → bootc-image-builder → osbuild → Bootable Disk Image
 
-https://salsa.debian.org/debian/ostree/-/raw/debian/latest/debian/ostree-boot-examples/README.md
+[rpm-ostree](https://github.com/projectatomic/rpm-ostree)\
+[bootc base-images](https://gitlab.com/fedora/bootc/base-images)\
+[bootc-image-builder](https://github.com/osbuild/bootc-image-builder)\
+[osbuild packages](https://packages.fedoraproject.org/pkgs/osbuild/) ( [source code](https://github.com/osbuild/osbuild) )\
 
-https://salsa.debian.org/debian/ostree/-/raw/debian/latest/debian/ostree-boot-examples/deb-ostree-builder 
+[ostree documentation](https://ostreedev.github.io/ostree/)\
+[bootc documentation](https://bootc-dev.github.io/bootc/)
 
-https://salsa.debian.org/debian/ostree/-/raw/debian/latest/debian/ostree-boot-examples/modified-deb-ostree-builder 
+## Debian official info
+[Debian ostree-boot-examples](https://salsa.debian.org/debian/ostree/-/tree/debian/latest/debian/ostree-boot-examples?ref_type=heads)
 
-https://salsa.debian.org/debian/ostree/-/raw/debian/latest/debian/ostree-boot-examples/ostree-1.conf 
+[man files](https://salsa.debian.org/debian/ostree/-/tree/debian/latest/man?ref_type=heads)
 
-https://salsa.debian.org/debian/ostree/-/raw/debian/latest/debian/ostree-boot-examples/ostree-2.conf 
+## EndlessOS
+[deb-ostree-builder](https://github.com/dbnicholson/deb-ostree-builder)
+https://github.com/endlessm/eos-image-builder
+[eos-updater](https://github.com/endlessm/eos-updater)
+https://github.com/endlessm/eos-boot-helper
 
-# MAN files
-https://salsa.debian.org/debian/ostree/-/tree/debian/latest/man?ref_type=heads
-
-https://github.com/dbnicholson/deb-ostree-builder
-
-https://github.com/stb-tester/apt2ostree
-
-https://lwn.net/Articles/821367/
-
-https://github.com/endlessm/eos-updater
+### Distrobution build tools
+[debos](https://github.com/go-debos/debos) is a tool-chain for simplifying the
+process of building a Debian-based OS image.
 
+## Apertis
 https://www.apertis.org/
 https://www.apertis.org/guides/image_devel/ostree/
 https://gitlab.apertis.org/pkg/apertis-update-manager
 
+# Debian/apt
+https://github.com/stb-tester/apt2ostree
+https://lwn.net/Articles/821367/
+
+## Debian Atomic (unproven)
+Treefile → apt-ostree → Container Image → Registry Upload → bootc-image-builder → debian-forge(osbuild) → Bootable Disk Image
 https://git.raines.xyz/particle-os/apt-ostree
 https://git.raines.xyz/particle-os/deb-bootc-image-builder
 https://git.raines.xyz/particle-os/debian-forge