diff --git a/README.md b/README.md
index bba4219..af66b98 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,12 @@ polyfilling missing features across platforms,
 but pre-existing software still takes a lot of
 tweaking to before becoming fully functional.
 
+## building
+
+on most Linux distros with podman properly installed and configured,
+it should suffice to run ./build-all in the root of the repository.
+binaries are output to the `out` directory upon success.
+
 ## notes
 
 ### Docker