1 files changed, 21 insertions, 0 deletions
diff --git a/DOCS.md b/DOCS.md
new file mode 100644
index 0000000..64aaacf
--- /dev/null
+++ b/DOCS.md
@@ -0,0 +1,21 @@
+## build-tools/* files
+
+Contains helper scripts/tools and config for building/managing ShopnoOS Package
+repository.
+
+#### buildroot usage
+```sh
+# buildroot create [distribution] [architecture]
+# Create cowbuilder chroot for cross-building packages
+$ buildroot create bullseye arm64
+
+# buildroot build [distribution] [arch]
+# builds packages for [arch] architecture on [distribution] release
+# * must be executed inside a dpkg source tree (with debian/ tree)
+# ** buildroot for [distribution] and [arch] required to use this
+$ buildroot build bullseye armhf
+
+# buildroot update [distro] [arch]
+# Update buildroot for [distro]:[arch]
+$ buildroot update bullseye armel
+```