Cara membuat artikel bantuan dengan AI: dari rekaman layar hingga dokumentasi yang dipublikasikan

Menulis artikel bantuan secara manual adalah salah satu tugas yang paling memakan waktu dalam alur kerja dokumentasi. Anda membuka dokumen, menjelaskan proses dari ingatan, menambahkan tangkapan layar satu per satu, memformat semuanya, dan meninjaunya sebelum dipublikasikan. Untuk satu artikel saja, itu membutuhkan waktu satu jam atau lebih. Untuk pusat bantuan lengkap yang mencakup setiap fitur dan alur kerja, itu adalah proyek berbulan-bulan — yang sebagian besar tim tidak pernah selesaikan.

Artikel bantuan yang dihasilkan AI mengubah alur kerja secara mendasar. Alih-alih menulis dokumentasi, Anda mendemonstrasikan prosesnya di layar dan membiarkan AI membuat artikel dari apa yang diamatinya. Jika Anda memilih perangkat lunak sebelum membangun proses, mulailah dengan ikhtisar generator dokumentasi AI Clevera — lalu gunakan panduan ini untuk menyusun artikel dalam skala besar.

Berikut cara kerjanya, seperti apa hasilnya, dan cara membangun pusat bantuan dalam skala besar menggunakan pendekatan ini.

Apa isi artikel bantuan yang baik#

Sebelum masuk ke pembuatan, ada baiknya kita tepat mengenai apa isi artikel bantuan yang berguna — karena konten yang dihasilkan AI harus memenuhi standar yang sama dengan konten yang ditulis secara manual.

Judul yang jelas yang sesuai dengan cara pengguna mencari: "Cara menghubungkan Salesforce" akan lebih mudah ditemukan daripada "Pengaturan Integrasi CRM." Tulis judul dari perspektif pengguna, bukan produk.

Pendahuluan singkat yang menetapkan konteks: 1-2 kalimat yang menjelaskan apa yang dibahas artikel dan kapan pengguna akan membutuhkannya. Ini membantu pengguna memastikan mereka berada di tempat yang tepat sebelum membaca lebih lanjut.

Instruksi langkah demi langkah bernomor: setiap langkah adalah satu tindakan. Bukan "Konfigurasikan pengaturan Anda dan simpan," melainkan "Klik ikon roda gigi di sudut kanan atas" diikuti dengan "Pilih Notifikasi dari menu sebelah kiri." Satu langkah, satu tindakan.

Tangkapan layar yang disematkan pada momen yang tepat: tangkapan layar harus menunjukkan status UI yang akan ditemui pengguna pada setiap langkah penting. Bukan satu tangkapan layar per tindakan, melainkan tangkapan layar di mana sesuatu di layar perlu dikenali atau diverifikasi.

Konteks dalam setiap langkah: deskripsi langkah yang menjelaskan tidak hanya apa yang harus diklik tetapi mengapa. "Pilih Pemilik untuk menetapkan kesepakatan kepada perwakilan yang bertanggung jawab atas akun tersebut" memberi pengguna konteks yang mereka butuhkan untuk membuat pilihan yang tepat, bukan hanya mengikuti instruksi secara mekanis.

Titik akhir yang jelas: artikel harus berakhir ketika tugas selesai, dengan konfirmasi tentang apa yang telah dicapai pengguna. "Integrasi Anda sekarang terhubung. Data akan disinkronkan setiap 15 menit."

Tautan ke artikel terkait: jika relevan, tautkan ke langkah logis berikutnya atau tugas terkait. "Sekarang setelah Anda menghubungkan Salesforce, lihat cara mengonfigurasi pengaturan sinkronisasi."

Pembuatan AI menghasilkan semua elemen ini secara otomatis ketika rekaman sumbernya jelas.

Bagaimana AI membuat artikel bantuan dari rekaman layar#

Proses dimulai dengan rekaman layar dari alur kerja yang Anda dokumentasikan. Anda melakukan tugas di layar — mengeklik produk, menyelesaikan langkah-langkah dari awal hingga akhir — sementara alat khusus menangkap semuanya.

Setelah Anda selesai merekam, AI menganalisis rekaman tersebut:

1. AI mengidentifikasi tindakan yang bermakna: setiap klik, navigasi, input bidang, dan perubahan status yang signifikan. Keraguan kecil dan tindakan yang tidak disengaja disaring.

2. AI menafsirkan konteks: AI tidak hanya melihat "klik terjadi di sini." AI memahami aplikasi apa yang Anda gunakan, apa nama elemen UI-nya, dan apa fungsi setiap tindakan dalam konteks alur kerja yang lebih luas.

3. AI menulis deskripsi langkah: setiap langkah mendapatkan deskripsi yang menjelaskan tindakan dan tujuannya. Bukan transkrip gerakan mouse, melainkan dokumentasi yang dapat diikuti pengguna secara mandiri.

4. AI memilih dan menyematkan tangkapan layar: tangkapan layar yang relevan diambil dari rekaman pada saat yang paling berguna — ketika layar baru muncul, ketika elemen UI penting perlu diidentifikasi, ketika konfirmasi tindakan itu penting.

5. AI menyusun artikel: header, langkah bernomor, pendahuluan, dan pemformatan diterapkan secara otomatis, menghasilkan artikel yang siap untuk pusat bantuan Anda tanpa penataan ulang manual.

Membuat artikel bantuan dengan Clevera#

Clevera adalah generator dokumentasi AI untuk Mac dan Windows yang menghasilkan video tutorial bernarasi dan artikel bantuan terstruktur dari satu rekaman layar. Pembuatan artikel bersifat otomatis dan bersamaan dengan video — Anda tidak menjalankan proses terpisah untuk setiap format.

Alur kerja lengkap:

Rekam: Buka Clevera dan mulai rekaman layar. Telusuri fitur atau alur kerja yang ingin Anda dokumentasikan. Bergeraklah dengan kecepatan alami, dari titik masuk tugas hingga penyelesaiannya. Anda tidak perlu menarasikan — AI menulis artikel dan sulih suara dari apa yang dilihatnya di layar.

Hasilkan: Hentikan rekaman. Clevera memproses rekaman di cloud. AI menghasilkan video tutorial dan artikel bantuan secara bersamaan. Beberapa menit setelah Anda berhenti merekam, kedua aset siap di editor.

Tinjau: Buka artikel di editor Clevera yang mirip Notion. Baca langkah-langkahnya dan verifikasi keakuratannya. Dalam kebanyakan kasus, hasilnya hampir siap dipublikasikan. Anda dapat mengedit deskripsi langkah apa pun secara langsung, menambahkan kotak keterangan untuk peringatan atau tips, menyisipkan blok kode, menyesuaikan nada (lebih formal, lebih santai), atau meminta AI untuk memperluas atau menyederhanakan bagian tertentu. Tambahkan atau hapus tangkapan layar sesuai kebutuhan.

Publikasikan: Ekspor langsung ke pusat bantuan atau platform dokumentasi Anda. Pada paket Pro ke atas, Clevera mempublikasikan ke Notion, Confluence, GitHub, HelpScout, Gitbook, ClickUp, Readme, Bitbucket, dan banyak lagi. Video tutorial disematkan sebagai HTML di bagian atas halaman, dengan artikel tertulis di bawahnya. Pengguna Anda mendapatkan panduan visual dan teks yang dapat mereka pindai di tengah tugas.

Membuat panduan langkah demi langkah untuk setiap bagian produk Anda#

Nilai artikel bantuan yang dihasilkan AI meningkat seiring pertumbuhan pustaka. Ketika pembuatan artikel individu memakan waktu berjam-jam, pusat bantuan lengkap yang mencakup setiap fitur dan alur kerja adalah proyek setahun. Ketika pembuatan artikel individu memakan waktu beberapa menit, pusat bantuan lengkap yang sama dapat dicapai dalam beberapa minggu.

Bagi tim yang berkomitmen pada pendekatan ini, alur kerjanya menjadi: fitur baru dirilis → anggota tim merekam alur kerja → Clevera membuat artikel bantuan → tinjau → publikasikan. Dokumentasi tetap mengikuti produk alih-alih tertinggal selamanya.

Apa yang harus dibuat terlebih dahulu:

Artikel bantuan dengan dampak tertinggi adalah artikel yang menjawab pertanyaan dukungan yang paling umum. Periksa kotak masuk dukungan atau sistem tiket Anda. 10-20 pertanyaan teratas memberi tahu Anda dengan tepat alur kerja mana yang perlu didokumentasikan oleh pengguna Anda. Buat artikel tersebut terlebih dahulu — artikel tersebut memiliki nilai defleksi tiket langsung.

Dari sana, bangun secara sistematis: setiap fitur utama, setiap opsi konfigurasi, setiap alur kerja umum. Tujuannya adalah pusat bantuan di mana pengguna dapat menemukan dokumentasi yang jelas dan terkini untuk apa pun yang perlu mereka lakukan di produk Anda.

Menjaga artikel bantuan yang dihasilkan tetap terkini#

Artikel bantuan yang mendokumentasikan produk yang berubah menjadi usang. Artikel yang menampilkan UI lama setelah desain ulang lebih buruk daripada tidak ada artikel — itu membingungkan pengguna dan mengikis kepercayaan pada dokumentasi Anda.

Dua faktor membuat artikel yang dihasilkan AI lebih mudah untuk tetap terkini daripada artikel yang ditulis secara manual:

Pembuatan ulang secepat pembuatan awal: ketika alur kerja berubah, Anda merekam ulang alur yang diperbarui dan membuat artikel baru. Waktu pembuatan ulang sama dengan waktu pembuatan asli. Tidak ada "overhead pembaruan" yang membuat pemeliharaan lebih lambat daripada pembuatan awal.

LiveSync untuk komponen video: video tutorial yang disematkan di bagian atas setiap artikel akan langsung aktif setelah dipublikasikan. Perubahan narasi, pembaruan gaya visual, dan penyesuaian callout akan langsung diterapkan di setiap sematan saat Anda memublikasikannya dari editor Clevera. Untuk perubahan yang tidak memerlukan rekaman baru, Anda bahkan tidak perlu merekam ulang.

Pustaka dokumentasi yang benar-benar mutakhir adalah pustaka dengan biaya pemeliharaan yang cukup rendah sehingga tim benar-benar melakukannya. Pembuatan konten berbasis AI menurunkan biaya tersebut ke tingkat di mana dokumentasi yang mutakhir menjadi hal yang praktis, bukan sekadar impian.

Bagaimana dengan artikel yang tidak dimulai dari rekaman?#

Tidak semua artikel bantuan mendokumentasikan alur kerja layar. Beberapa di antaranya adalah penjelasan konseptual, FAQ, panduan pemecahan masalah, atau materi referensi yang tidak memiliki demonstrasi langkah demi langkah. Untuk konten ini, editor Clevera yang mirip Notion memungkinkan Anda membuat artikel dari awal atau menggunakan bantuan AI untuk menyusun draf dan struktur konten.

Alur kerja perekaman layar adalah jalur tercepat untuk konten prosedural. Untuk konten lainnya, editor ini memberi Anda titik awal tanpa perlu melalui langkah perekaman.