Transklusi Simbol
Embed kode langsung ke dalam dokumentasi Anda berdasarkan nama, bukan nomor baris. Edit sumbernya, dokumentasi Anda diperbarui secara otomatis.
# Embed fungsi berdasarkan nama
![[auth.py#validate_token]]Ohai mengekstrak fungsi validate_token dari auth.py dan merendernya secara inline dengan syntax highlighting. Ketika fungsi berubah, dokumentasi Anda diperbarui secara otomatis.
Mengapa penting
Dokumentasi tradisional mudah usang. Anda copy-paste kode ke dalam markdown, kode berkembang, dan tiba-tiba dokumentasi Anda menjadi tidak akurat. Transklusi simbol memperbaiki ini dengan memperlakukan file sumber Anda sebagai satu-satunya sumber kebenaran.
Tidak seperti referensi nomor baris yang rusak setiap kali refactor, transklusi simbol menggunakan parsing AST untuk menemukan kode berdasarkan nama sebenarnya—fungsi, class, struct, konstanta. Ubah nama file, reorganisasi kode Anda, tambahkan method baru—selama nama simbol masih ada, dokumentasi Anda tetap akurat.
Kasus Penggunaan
Dokumentasi API
Referensikan signature fungsi yang sebenarnya, bukan pendekatan yang diketik manual dan tidak sinkron.
Architecture Decision Records
Embed kode yang Anda diskusikan dalam ADR. Contohnya tetap up-to-date seiring kodebase berkembang.
Panduan Onboarding
Tunjukkan kepada developer baru bagaimana autentikasi bekerja dengan kode langsung yang bisa mereka percaya sesuai dengan repo.
Code Review
Tarik fungsi spesifik ke dalam ringkasan markdown untuk review dan diskusi asinkron.
Tutorial
Jelaskan implementasi nyata. Pembaca dapat mempercayai bahwa contoh kode selalu up-to-date.
Runbook
Embed config atau skrip yang persis seperti yang perlu direferensikan ops saat insiden.
Bahasa yang Didukung
30+ bahasa via parsing AST Tree-sitter. Bahkan key JSON, path YAML, dan tabel TOML.
Siap mencoba dokumentasi yang tidak pernah usang?
Unduh untuk Mac