Changelog
Pembaruan stabilitas API playground
- Pencarian untuk menemukan endpoint
- Menandai endpoint yang sudah usang dengan tag
- Menyembunyikan halaman API yang dibuat otomatis dari navigasi
- Mengunggah file multipart atau form data
Pelajari lebih lanjut di dokumentasi API playground.
npm i mint
Sekarang dapat menggunakan npm i mint@latest -g
untuk meningkatkan CLI Anda.
Web Editor 3.0
Perbaikan kegunaan besar-besaran dalam editor WYSIWYG.
Peningkatan besar
- Cari nama file menggunakan pintasan ⌘ + P
- Halaman dimuat 10x lebih cepat
- Waktu muat lebih cepat saat mencari cabang
- Tab opsi halaman untuk mengonfigurasi tata letak, judul, & metadata untuk SEO
- Toolbar mengambang saat Anda menyorot teks
Perbaikan tambahan
- Memperbaiki margin atas untuk komponen changelog
- Meningkatkan keandalan perilaku klik kanan
- Setelah mengklik publikasi, Anda akan tetap berada di halaman yang sama alih-alih dibawa ke keadaan kosong
- Standarisasi warna pada ikon file
- Meningkatkan keandalan setelah memilih cabang baru beberapa kali berturut-turut
- Menghapus mode Diff
- Lebih konsisten saat membuat folder baru dari dropdown
- Memperbaiki kutipan blok yang membuat lebih banyak kutipan blok saat mencoba untuk membatalkan pilihan
Terjemahan AI dalam beta
Terjemahkan semua dokumentasi Anda dengan AI. Pelajari lebih lanjut.
Ekspor dokumen ke PDF dalam beta
Ekspor semua dokumentasi Anda, subdirektori, atau halaman tunggal sebagai PDF.
Dukungan React hook
Bawa interaktivitas ke dokumen Anda. Semua React hook standar secara otomatis tersedia di file MDX Anda. Pelajari lebih lanjut.
Generator server MCP
Hasilkan server MCP sehingga aplikasi AI dapat berinteraksi dengan dokumen atau API Anda. Konten tertulis secara otomatis dihasilkan sebagai server MCP, dan Anda dapat menghasilkan server MCP dari spesifikasi OpenAPI Anda dengan satu klik. Lihat dokumentasi tentang memulai dengan MCP.
Peningkatan
- Tag pembaruan changelog sehingga pengguna akhir dapat memfilter pembaruan
- Sonnet-3.7 didukung untuk AI Chat. Konfigurasikan model pilihan Anda melalui dasbor
- Ubah nama deployment Anda langsung di pengaturan dasbor
Perbaikan bug
- Gambar OG diperbaiki
- Memperbaiki inkonsistensi gaya ikon untuk jangkar tanpa wadah
- Meningkatkan detail gaya untuk batas dasbor untuk responsivitas mobile-tablet-desktop
- Menampilkan contoh kode bahkan ketika dalam mode sederhana untuk API playground
- Mendukung pintasan “command + k” untuk pencarian di editor web
- Blok kode dalam callout diperluas untuk mengisi lebar area callout
Skema konfigurasi baru docs.json
Kami telah memperkenalkan docs.json
skema baru sebagai pengganti mint.json
, untuk mendukung versi multi-level yang lebih baik, pemahaman visual yang lebih mudah, dan terminologi yang lebih konsisten. Untuk informasi lebih lanjut tentang apa yang berubah, lihat blog kami.
Tingkatkan dari mint.json
ke docs.json
dengan langkah-langkah berikut:
- Pastikan CLI Anda adalah versi terbaru
- Di repositori dokumen Anda, jalankan
- Hapus file mint.json lama Anda dan push perubahan Anda
Pemeriksaan CI
Secara otomatis periksa dokumen Anda untuk menemukan tautan yang rusak, menemukan masalah ejaan dan tata bahasa, atau menerapkan gaya penulisan dengan konfigurasi Vale Anda sendiri. Pelajari lebih lanjut di dokumentasi kami.
Dukungan .md untuk LLM
Semua halaman dokumentasi sekarang secara otomatis tersedia sebagai file Markdown biasa—cukup tambahkan .md
ke URL. Ini memudahkan LLM untuk mengambil halaman individu dari dokumentasi Anda.
Lebih Banyak Tema
Tema pra-dibuat baru untuk memodifikasi tampilan & nuansa dokumen Anda. Konfigurasikan melalui file docs.json Anda.
Sekarang tersedia:
- Maple
- Palm
- Willow
Peningkatan lainnya
- Panduan Penulisan Teknis:Praktik terbaik untuk menulis dokumentasi teknis, termasuk penelitian audiens, jenis konten, dan tips penulisan.
- Komponen dropdown: Atur navigasi dengan dropdown, selain tab dan jangkar.
- Perbaikan sintaks AI: Editor web akan menangkap jika ada kesalahan parsing dan menggunakan AI untuk menyarankan perbaikan.
Peningkatan Asisten AI
- UI baru dengan halaman obrolan khusus & prompt yang sudah diisi
- Peningkatan stabilitas, misalnya perbaikan bug mengedit file yang salah atau tidak ada file sama sekali
- Pengetahuan yang lebih kuat untuk menambah & mengedit komponen
- Peningkatan pengeditan file mint.json
Autentikasi Parsial
Sesuaikan akses ke halaman atau bagian konten apa pun tergantung pada izin pengguna. Mendukung koneksi dengan sistem autentikasi Anda sendiri.
API Playground yang Diperbarui
Kami telah memperbarui desain dan kinerja API Playground. Pembaruan meliputi:
- Ekspansi detail yang lebih mudah untuk ikhtisar sebuah bidang
- Desain bersarang yang lebih intuitif, misalnya menambah atau menghapus item
- Waktu respons yang lebih cepat
Peningkatan Kualitas
- Dukungan untuk mewajibkan autentikasi untuk mengakses deployment pratinjau
Autentikasi
Buat dokumen menjadi pribadi dengan mengatur autentikasi melalui JWT, OAuth, atau kata sandi universal. Dengan privasi ini, Anda dapat membuat basis pengetahuan internal atau mencegah pesaing melihat dokumen Anda.
Asisten AI
Sekarang Anda dapat meminta AI untuk membuat perubahan pada dokumen Anda, dengan konteks semua dokumentasi yang ada. Ketik prompt dan asisten akan mengusulkan perubahan dengan menghasilkan permintaan tarik.
Peningkatan Integrasi GitLab
Kami telah meningkatkan dukungan kami untuk sinkronisasi dengan GitLab, seperti mengaktifkan pembaruan otomatis dan deployment pratinjau. Lihat dokumentasi kami tentang GitLab untuk memulai.
Editor Web
Kami telah memperbarui editor web kami sehingga Anda sekarang dapat memperbarui dokumen dengan pengalaman WYSIWYG sepenuhnya, sambil tetap sinkron dengan markdown.
Lihat dokumentasi kami tentang memulai dengan Web Editor.
/llms.txt support
Semua instance dokumen sekarang secara otomatis di-host di /llms.txt dan /llms-full.txt sehingga LLM dapat dengan mudah mengambil dokumentasi Anda. Untuk informasi lebih lanjut, baca dokumentasi tentang standar llms.txt yang baru.
Lokalisasi
Anda sekarang dapat melokalisasi dokumen Anda yang beroperasi mirip dengan versi. Tambahkan locale
ke versi dan konten tetap di Mintlify seperti “Apakah halaman ini membantu?” juga akan sesuai dengan lokal.
Peningkatan Kualitas
- Mengembalikan hasil obrolan & pencarian berdasarkan versi saat ini yang sedang dibaca pengguna
- Autentikasi pengguna dengan OAuth, selain token JWT atau Shared Session.
Changelogs
Meluncurkan Update component baru untuk memudahkan menampilkan dan melaporkan pembaruan (seperti ini) kepada pengguna Anda.
Penyorotan Baris Kode
Anda sekarang dapat menyorot baris kode dalam dokumen Anda untuk menekankan dan menarik perhatian pada bagian-bagian penting dengan menambahkan komentar khusus setelah pengidentifikasi bahasa. Gunakan kurung kurawal {}
dan tentukan nomor baris atau rentang yang dipisahkan dengan koma.
Blok kode mode terang
Blok kode sekarang memiliki varian mode terang yang dapat diaktifkan dengan menambahkan berikut ke mint.json
:
Footer Lanjutan
Anda sekarang dapat menambahkan lebih banyak tautan ke footer standar. Peningkatan ini memberikan konsistensi yang lebih baik antara halaman landing dan dokumen, atau kustomisasi yang lebih besar jika Anda ingin menyoroti halaman tertentu seperti sosial media atau log status.
Filter pencarian berdasarkan pengguna saat ini
Ketika personalisasi diaktifkan, hasil pencarian sekarang difilter berdasarkan pengguna yang saat ini masuk sehingga mereka hanya melihat konten yang relevan.
Prompt Kustom untuk AI Chat
Anda sekarang dapat menyesuaikan prompt untuk AI chat. Silakan hubungi support jika Anda ingin menyesuaikan prompt.
Peningkatan Dashboard
- Menambahkan kemampuan untuk mengubah domain kustom menjadi /docs langsung melalui pengaturan dashboard.
- Menggabungkan halaman login dan pendaftaran untuk mengurangi gesekan dan kebingungan.
- Menerapkan alur login penemuan sehingga pengguna yang menjadi anggota beberapa organisasi sekarang dapat beralih di antara mereka.
- Menambahkan login dengan Google OAuth
- Menambahkan kemampuan untuk menambahkan deployment baru melalui pengaturan dashboard.
Perbaikan Bug
- Sekarang dapat menggunakan garis miring di depan dalam navigasi.
- Sekarang dapat mengedit file CSS & JS di editor web.
- Memperbaiki
suggestEdit
yang tidak muncul meskipun diaktifkan. - Memperbaiki navigasi keyboard untuk Pencarian dan Chat sehingga Anda sekarang dapat menggunakan tombol panah atas dan bawah untuk menavigasi hasil.
- Tidak mengizinkan mesin pencari untuk merayapi halaman yang dilindungi otentikasi pengguna.
- Memvalidasi ulang cache ketika sebuah organisasi dihapus.
- Kami sekarang menggunakan parser OpenAPI Scalar untuk mengurai definisi OpenAPI yang meningkatkan kinerja, memperbaiki masalah penguraian, dan menampilkan pesan kesalahan yang lebih baik.
- Deskripsi tingkat atas sekarang didukung di halaman referensi API yang dibuat secara otomatis dari definisi OpenAPI.
- Menambahkan dukungan gaya in-line untuk ikon
- Memperbaiki pop-in CSS kustom di dokumen.
- Menampilkan gaya kode in-line dengan benar bersama dengan tautan.
- Mempertahankan posisi gulir ketika Anda mengklik tombol kembali di browser.
Font Kustom
Personalisasikan font dokumen Anda dengan font Anda sendiri yang di-host di CDN atau dengan memilih dari Google fonts untuk mencocokkan dokumen Anda dengan merek Anda.
Gambar dalam komponen Card
Tambahkan properti img
ke kartu untuk menampilkan gambar di bagian atas kartu. Pelajari lebih lanjut tentang hal ini di sini.
Peningkatan Kecepatan Pembaruan
Untuk proyek besar (~3.000 file), langkah unduhan untuk pembaruan dokumen sekarang ~440x lebih cepat - pengurangan waktu 99,8%. Secara keseluruhan, unduhan file selama pembaruan sekarang ~5,5x lebih cepat - pengurangan waktu 81,8%.
Peningkatan SEO
Kami telah memperbaiki tata letak dokumen kami baik untuk mobile maupun desktop sehingga lebih ramah SEO - termasuk menambahkan tag aria yang tepat ke elemen navbar dan toggle.
Peningkatan Dashboard
- Migrasi router aplikasi di dashboard.
- Analitik pencarian sekarang tersedia di dashboard.
- Fungsi menghapus organisasi telah ditambahkan ke dashboard.
- Mengirimkan UI koneksi GitLab.
- Memperbaiki data analitik yang tidak akurat.
- Add-on sekarang dapat dibeli langsung melalui dashboard.
Perbaikan Bug
- Memperbaiki bug di mana bar atas tidak akan melebar ke lebar layar ketika dalam mode kustom dan tata letak sidebar adalah
sidenav
. - Memperbaiki posisi relatif widget AI.
Lainnya
- Pemecahan masalah untuk halaman API: Halaman API bisa rumit sehingga kami mencantumkan masalah umum untuk membantu Anda menyelesaikannya dengan cepat —Baca dokumentasinya
Halaman Referensi OpenAPI
- Endpoint yang didefinisikan oleh OpenAPI yang kompleks dan rekursif sekarang 98% lebih kecil.
- Kami sekarang menampilkanadditionalPropertiesdi halaman OpenAPI.
Unggahan File di API Playground
Secara default, permintaan API playground diproksikan oleh Mintlify. Sekarang Anda dapat menggunakandisableProxy
untuk menonaktifkan perilaku ini dan mendukung jenis permintaan seperti unggahan file.
Peningkatan SEO mobile
Kami telah memperbaiki tata letak mobile dari dokumen kami sehingga lebih ramah SEO - termasuk menambahkan tag aria yang tepat ke elemen.
Formulir Dukungan
Kami menambahkan formulir dukungan yang lebih rinci ke dashboard Mintlify. Anda sekarang dapat mengirimkan formulir untuk menghubungi kami.
Perbaikan Bug
- Memperbaiki bug untuk fungsionalitas integrasi Segment.
- Kami sekarang menampilkan pesan kesalahan yang lebih rinci untuk izin GitHub saat berinteraksi dengan editor.
- Memperbaiki bug di mana navigasi tidak akan memperluas dengan benar ketika tautan langsung digunakan.
Widget AI
Untuk Pro
pengguna, kami memperkenalkan Mintlify Widget, sebuah ekstensi dari dokumentasi Anda untuk
menjawab pertanyaan pengguna Anda kapan dan di mana mereka bertanya. Anda dapat menambahkan
chatbot bertenaga AI ini ke halaman web mana pun: halaman landing Anda, di dalam produk Anda, atau
di halaman dokumentasi Anda yang sudah ada.
Pro Plan
Kami juga memperbarui paket harga kami untuk kustomisasi dan skala yang lebih baik.
Sinkronisasi Contoh Kode API Playground
Saat Anda menjelajahi dokumentasi API, contoh kode yang dipilih sekarang disinkronkan di seluruh halaman Anda.
Insights
Saat ini dalam versi beta, fitur ini merangkum pertanyaan dan pola umum pengguna menjadi laporan yang mudah dicerna dengan saran bertenaga AI tentang cara meningkatkan produk Anda.
Sorotan Minggu Peluncuran
- Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your
mint.json
file dan itu akan memperbarui gaya dokumentasi Anda. - Search V2: langsung kueri deskripsi dan judul endpoint OpenAPI untuk mencapai halaman Referensi API, hapus halaman tersembunyi dari pencarian, dan nikmati UI bilah pencarian kami yang diperbarui.
- Percabangan Editor Web: buat cabang di editor web kami tanpa IDE.
- Personalisasi Pengguna: autentikasi pengguna dengan Shared Session atau JWT sehingga Anda dapat menunjukkan konten yang disesuaikan kepada mereka, seperti mengisi kunci API atau menampilkan konten tertentu untuk pelanggan.
- Peningkatan Otomatisasi OpenAPI: untuk mengisi otomatis halaman API Playground, Anda dapat menambahkan
openapi
field ke objek dalam array tabs atau anchors di mint.json.
Mode kustom
Tambahkan konfigurasi ke metadata untuk menghapus semua elemen kecuali bilah atas. Contoh kasus penggunaan:
- Buat pengaturan halaman landing global kustom dengan komponen kustom
- Tambahkan video layar penuh atau galeri gambar
- Sematkan elemen demo iFrame kustom untuk menambahkan interaktivitas ke dokumentasi Anda
Lihat Custom Mode docs.
Mintlify MDX untuk VSCode
Panggil cuplikan komponen dan callout pra-bangun kami tanpa meninggalkan VSCode. Install the extension here.
Peningkatan Kualitas
- Peningkatan dashboard: lihat log pembaruan untuk melihat apa yang berubah dan status pembaruan, beralih antara proyek Mintlify untuk mengelola deployment
- Versi dengan tab sekarang didukung sepenuhnya
- Pengalihan wildcard sekarang didukung
- Deteksi Kesalahan CLI: kami sekarang menunjukkan posisi frontmatter yang tidak valid ketika ada masalah parsing selama pengembangan lokal
Sorotan Minggu Peluncuran
- Preview Deployment: Ketika Anda membuat pull request, kami akan menghasilkan tautan unik yang menunjukkan pratinjau langsung tentang bagaimana dokumentasi Anda terlihat di produksi. Anda dapat membagikan tautan ini dengan rekan tim.
- Snippets V2: Kami sekarang mendukung komponen yang sepenuhnya dapat digunakan kembali dan variabel untuk cuplikan.
- Mesin MDX Open-source: Kami telah mengekspos dua API—getCompiledMdx dan MDXComponent—sehingga Anda dapat mengakses markdown Mintlify dan penyorotan sintaks kode. Contributions to the project diterima dengan senang hati.
- Wawasan AI Chat: Segmentasi riwayat obrolan berdasarkan tanggal dan tingkatkan kuota AI Chat dari dashboard, dan lihat seberapa sering kueri tertentu muncul.