Tim sumber terbuka Meta baru-baru ini merilis Docusaurus 3.9, pembaruan penting untuk generator situs statis berbasis React yang populer.
Versi barunya, diumumkan pada tanggal 25 September, memperkenalkan kemampuan baru yang signifikan: asisten penelusuran yang didukung AI.
Selain fitur-fitur baru, pembaruan ini juga memodernisasi teknologi yang mendasarinya, sehingga mengharuskan pengembang untuk menggunakan Node.js 20 dan mengakhiri dukungan untuk Node.js 18 yang lebih lama.
Penelusuran Percakapan yang Didukung AI dengan DocSearch v4
Bagi pengembang yang memelihara dokumentasi berskala besar, tambahan yang menonjol di Docusaurus 3.9 adalah dukungan penuh untuk DocSearch v4 Algolia.
Peningkatan ini memperkenalkan AskAI, sebuah fitur yang mengubah bilah pencarian standar situs menjadi asisten percakapan.
Daripada hanya mencocokkan kata kunci, alat ini memberikan jawaban yang disintesis, membantu pengguna memecahkan masalah lebih efisien.
Menurut tim Docusaurus, tujuannya adalah “memungkinkan Anda menambahkan asisten pencarian bertenaga AI ke situs Docusaurus Anda yang dapat menjawab pertanyaan berdasarkan apa yang ada di dokumentasi Anda dengan pengalaman percakapan.”
Peralihan dari pengambilan kata kunci ke jawaban percakapan menandai evolusi besar dalam pengalaman pengguna untuk dokumentasi teknis.
Implementasi pencarian lanjutan ini bersifat opt-in, memberi kontrol tim atas transisi. Pengelola proyek dapat memilih untuk tetap menggunakan DocSearch v3 atau meningkatkan versi secara bertahap untuk membuka kemampuan AI baru.
Bagi mereka yang siap mengadopsinya, Algolia menyediakan titik masuk yang dapat diakses. Halaman harga resminya memerinci tingkat “Build”gratis yang mencakup 10.000 permintaan penelusuran per bulan, sehingga menjadikan fitur ini layak digunakan untuk proyek sumber terbuka dan tim yang lebih kecil.
Integrasi tersebut mencerminkan tren industri yang lebih luas dalam menyematkan AI generatif langsung ke platform pengembang untuk meningkatkan produktivitas dan mengurangi gesekan pengguna.
Memodernisasi Fondasi: Node.js 20 Sekarang Diperlukan
Dalam langkah yang bertujuan untuk meningkatkan keamanan dan kinerja, Docusaurus 3.9 menaikkan persyaratan waktu proses minimumnya ke Node.js v20.0, secara resmi menghentikan dukungan untuk Node.js 18.
Karena Node.js 18 telah mencapai akhir masa pakai resminya, maka Node.js 18 tidak lagi menerima pembaruan keamanan, sehingga penggunaan berkelanjutannya berpotensi menjadi kerentanan.
Tim Docusaurus membingkai pemutakhiran wajib ini sebagai langkah penting untuk mempertahankan platform yang aman dan stabil.
“Menghapuskan versi Akhir Masa Pakainya penggunaan Node.js pada rilis versi minor adalah praktik umum di ekosistem Node.js, yang kini secara resmi kami dukung dan dokumentasikan pada proses rilis kami.”
Meskipun keputusan ini merupakan praktik terbaik, keputusan ini memerlukan tindakan dari tim pengembangan. Dampak paling langsung dari hal ini adalah pada pipeline CI/CD dan lingkungan pengembangan lokal.
Contoh praktis dari hal ini muncul di GitHub, saat seorang pengembang mengajukan masalah dengan menyatakan bahwa contoh dokumentasi resmi untuk GitHub Actions masih mengacu pada Node 18 tidak lagi digunakan, sehingga memerlukan pembaruan agar dapat berfungsi dengan benar.
Tim perlu mengaudit tidak hanya skrip build mereka tetapi juga Dockerfile dan pengelola lingkungan lokal untuk memastikan transisi yang lancar dan menghindari kegagalan build.
Peningkatan Fleksibilitas untuk Situs Dokumentasi Global
Untuk mengatasi tantangan lama untuk situs multi-bahasa, Docusaurus 3.9 memperkenalkan peningkatan signifikan pada internasionalisasi (i18n) sistem.
Pengembang sekarang dapat mengganti properti `baseUrl` dan `url` untuk setiap lokal satu per satu menggunakan kolom `i18n.localeConfigs[locale]` yang baru.
Ini memberikan kontrol terperinci yang diperlukan untuk penerapan multi-domain yang kompleks—misalnya, menghosting dokumen berbahasa Inggris di `docs.example.com` dan dokumen Prancis di `docs.example.fr`, sambil memastikan semua metadata dan tautan diselesaikan dengan benar.
Pengoptimalan i18n lebih lanjut mencakup tanda `translate` baru, yang sekarang dinonaktifkan secara default untuk situs tanpa terjemahan, sehingga mempercepat waktu pembangunan dengan menghindari pembacaan sistem file yang tidak perlu.
Selain itu, atribut `key` baru dapat ditetapkan ke item sidebar. Menambahkan kunci ini mencegah konflik kunci terjemahan ketika beberapa kategori berbagi label yang sama, seperti’API’, memastikan bahwa setiap instance dapat diterjemahkan secara unik berdasarkan konteksnya dalam struktur dokumentasi.
Peningkatan Penting untuk Diagram, Kinerja, dan Pengalaman Pengembang
Di luar fitur utama, Docusaurus 3.9 menggabungkan sejumlah peningkatan berharga lainnya.
Di antaranya adalah dukungan untuk algoritme tata letak Mermaid ELK. Mermaid adalah alat populer untuk membuat diagram dari teks, dan mesin tata letak ELK-nya memberikan kemampuan rendering yang lebih canggih, yang sangat berguna untuk arsitektur sistem yang besar atau rumit diagram.
Performa juga meningkat dengan upgrade ke Rspack 1.5, yang memanfaatkan opsi konfigurasi baru untuk mempercepat waktu build Docusaurus. Pembangunan yang lebih cepat berarti produktivitas developer yang lebih tinggi, khususnya dalam proyek besar.
Perubahan penting lainnya termasuk hook baru untuk menangani link Markdown yang rusak, kemampuan untuk menonaktifkan rendering emoji, dan peningkatan stabilitas visual saat beralih antar mode warna.
Penyempurnaan kolektif ini memperkuat posisi Docusaurus sebagai platform yang kuat, berperforma tinggi, dan fleksibel untuk membangun situs dokumentasi modern.
