Update README.md

README.md

@@ -1 +1,22 @@
 # Quansheng UV-K5, UV-K5(8) and UV-K6 Firmwares
+
+This repository is a collection of official Quansheng firmware binaries and community-developed custom firmwares for the UV-K5 and UV-K6 (also known as UV-K5(8)) radios.
+
+> [!WARNING]
+> Use these firmwares at your own risk (entirely). There is absolutely no guarantee that they will work in any way on your radio(s); it may even brick your radio(s), in which case you will need to buy another radio. Anyway, have fun.
+
+> [!CAUTION]
+> I recommend to backup your eeprom with [k5prog](https://github.com/sq5bpf/k5prog) before playing with alternative firmwares. It's a good reflex to have.
+
+## Official Quansheng Firmwares - [/official-firmwares](/official-firmwares)
+
+Only official manufacturer firmware, no modifications.
+
+Download the latest official firmware version: [v3.00.18](https://github.com/henriquesebastiao/uv-k5-firmwares/raw/refs/heads/main/official-firmwares/UV-K6/k6_v3.00.18.bin)
+
+## Custom Firmwares - [/custom-firmwares](/custom-firmwares)
+
+Contains the main firmwares developed, namely:
+
+- [A merge between **OneOfEleven/uv-k5-firmware-custom** and **fagci/uv-k5-firmware-fagci-mod**](https://github.com/egzumer/uv-k5-firmware-custom) by [@egzumer](https://github.com/egzumer)
+- [F4WN](https://github.com/armel/uv-k5-firmware-custom) by [@armel](https://github.com/armel)