https://arifnd.github.io/tags/mkdocs/ Recent content in MKDocs on Catatanku Hugo id Sat, 18 Jul 2026 10:00:00 +0700 https://arifnd.github.io/posts/membangun-dokumentasi-proyek-dengan-mkdocs/ Sat, 18 Jul 2026 10:00:00 +0700 https://arifnd.github.io/posts/membangun-dokumentasi-proyek-dengan-mkdocs/ <p>Selama beberapa minggu terakhir penulis mengembangkan <a href="https://github.com/arifnd/buckpow">BuckPow</a>, sebuah platform <em>open source</em> untuk <em>energy observability</em> dan <em>benchmarking</em> perangkat IoT serta <em>embedded system</em>. Saat ini repository tidak hanya berisi aplikasi <em>backend</em> berbasis Python, tetapi juga <em>firmware</em> untuk ESP8266/ESP32, dashboard web, REST API, contoh implementasi, hingga dokumentasi perangkat keras. Pada awal pengembangan, seluruh informasi penulis tampilkan di dalam <code>README.md</code>. Cara tersebut cukup efektif ketika proyek masih sederhana. Namun, setelah setelah beta rilis pertama, README mulai terasa kurang untuk menampung semua informasi mengenai proyek. Sehingga penulis mulai kesulitan menjaga dokumentasi untuk tetap rapi, pada kondisi tersebut penulis menyadari bahwa dokumentasi tidak bisa lagi diperlakukan sebagai lampiran proyek. Dokumentasi harus menjadi bagian dari proses pengembangan.</p>