YouTrack sekarang dengan basis pengetahuan

Halo, Habr!

Tim Youtrack Terhubung dari JetBrains. Pengguna kami telah lama meminta kami untuk membuat sesuatu yang memungkinkan mereka untuk menyimpan dokumentasi secara langsung di pelacak. Dan sebagai bagian dari rilis utama 2020.2, sebuah peristiwa penting terjadi: basis pengetahuan muncul di YouTrack. Sekarang Anda dapat mengumpulkan informasi berguna untuk bekerja di satu tempat dan menyimpan dokumentasi internal secara langsung di YouTrack, berdampingan dengan proyek dan tugas, dan pengguna eksternal Anda akan dapat menemukan jawaban atas pertanyaan mereka secara langsung di pelacak.

gambar

Untuk detailnya, selamat datang di pos.

Apa itu?


Kami tidak menciptakan sepeda: basis pengetahuan kami adalah kumpulan artikel. Artikel disusun dalam struktur pohon, yang merupakan akar dari proyek: dengan demikian, setiap proyek dapat memiliki struktur artikel yang bercabang.

gambar

Bagi mereka yang suka singkatnya, saya akan daftar di bawah fitur utama dari basis pengetahuan, dan bagi mereka yang tertarik melihat skrip dan gambar, selamat datang lebih lanjut.

Jadi, selain benar-benar membuat artikel, Anda dapat:
1. Cari artikel yang diinginkan menggunakan pencarian teks lengkap.
2. Gunakan editor WYSIWYG atau Markdown.
3. Buat berbagai konten menggunakan tabel, daftar periksa dan daftar yang dipesan, serta melampirkan atau menyematkan berbagai media - dari video YouTube ke dokumen Google.
4. Diskusikan artikel dalam komentar, sebutkan kolega dan tugas.
5. Berlangganan pemberitahuan perubahan dan komentar dalam artikel yang menarik bagi Anda.
6. Lihat versi artikel sebelumnya dan, jika perlu, kembalikan versi yang sebelumnya.
7. Kelola akses ke artikel baik menggunakan peran (kami menambahkan izin yang sesuai untuk mengontrol akses ke artikel di tingkat proyek) dan membatasi visibilitas masing-masing artikel (atau seluruh cabang artikel) menggunakan daftar visibilitas - seperti halnya untuk tugas.

OK, dan apa yang harus dilakukan?


Menurut pengalaman pengguna kami, ada dua skenario paling populer untuk menggunakan basis pengetahuan: dokumentasi tim internal (catatan pertemuan, jadwal liburan, panduan internal) dan basis pengetahuan publik untuk pengguna eksternal (pertanyaan yang sering diajukan, dokumentasi produk, peta jalan).

Dokumentasi internal tim Anda


Sulit membayangkan tim modern tanpa dokumentasi: catatan dari pertemuan, daftar periksa untuk anggota tim baru, atau bahkan instruksi untuk menyiapkan VPN. Basis pengetahuan YouTrack akan membantu mengumpulkan segala sesuatu di satu tempat, dan, tentu saja, itu akan berguna tidak hanya untuk tim pengembangan.
Katakanlah Anda mengatur pengembangan tim untuk kolega. Untuk merencanakan acara, buat artikel di basis pengetahuan dan mulai menuliskan ide-ide Anda di sana. YouTrack akan secara otomatis menyimpan konsep dan Anda dapat kembali kapan saja.

Di menu tarik-turun di atas judul artikel, tunjukkan kepada siapa artikel Anda akan terlihat. Anda dapat membatasi akses ke masing-masing dokumen dan cabang dalam hierarki artikel - sama seperti saat mengerjakan tugas. Secara default, artikel tersedia untuk semua orang yang memiliki izin untuk "membaca artikel" di proyek, tetapi Anda dapat mempersempit visibilitas ini kapan saja. Pengaturan visibilitas menyebar ke hierarki basis pengetahuan, sehingga sub-artikel akan terlihat oleh orang yang sama dengan artikel di hulu.

gambar

Membaca teks lengkap tidaklah mudah - dan di sini kemampuan editor kami datang untuk menyelamatkan. Misalnya, ingatkan kolega Anda betapa hebatnya pembangunan tim pada musim panas lalu dengan melampirkan video, atau susun konten Anda menggunakan tabel, daftar periksa, dan daftar yang dipesan.



Dan setelah publikasi artikel, saatnya untuk mengundang kolega untuk mendiskusikan ide Anda - mekanisme menyebutkan bekerja dengan cara yang sama seperti dalam tugas. Jangan khawatir, Anda tidak akan kehilangan apa pun - pemberitahuan akan muncul tentang komentar. Jika Anda ingin melacak apa yang terjadi di artikel penulis lain, cukup tandai dengan tanda bintang untuk menerima pemberitahuan juga.

Basis pengetahuan terbuka untuk pengguna Anda


Di basis pengetahuan, lebih mudah untuk menyimpan tidak hanya dokumentasi dan peta jalan. Pengguna Anda mungkin memiliki pertanyaan tentang penggunaan produk Anda. Mengumpulkan jawaban untuk pertanyaan umum dan panduan penggunaan di satu tempat dan menjadikannya tersedia untuk umum adalah cara terbaik untuk membuat hidup lebih mudah bagi pengguna Anda.

Pertama izinkan akses anonim.ke server YouTrack Anda sehingga pengguna eksternal dapat memasuki basis pengetahuan tanpa mendaftar. Kontrol akses sangat fleksibel - Anda dapat membuka cabang artikel terpisah untuk lingkaran orang tertentu: tim Anda, pengguna terdaftar, atau untuk semua orang. Sekarang yang harus Anda lakukan adalah mengisi basis pengetahuan Anda! Tulis artikel, tambahkan tabel, lampirkan file dan jangan takut untuk melakukan pengeditan - semua versi artikel akan tersedia di tab histori, dan Anda setiap saat dapat melihat perbedaan antara versi dan memutar kembali ke salah satu negara sebelumnya.

gambar

Jawab pertanyaan pelanggan dalam komentar pada artikel, terima pemberitahuan pembaruan, dan tautkan ke artikel dari basis pengetahuan dalam diskusi tugas. Sebutkan kolega dalam komentar jika bantuan mereka diperlukan, dan poskan tautan ke artikel dan tugas terkait - semua informasi yang diperlukan sudah ada di ujung jari Anda.

Pencarian Basis Pengetahuan


Baik di basis pengetahuan terbuka dan tertutup, pencarian teks lengkap berfungsi, yang menemukan semua artikel yang mengandung kata atau frasa pencarian. Sangat mudah untuk berpindah dari hasil pencarian ke artikel yang tepat untuk menemukan jawaban atas pertanyaan Anda.

gambar

Apakah Anda menggunakan ini di JetBrains?


Kami di tim YouTrack memiliki aturan: kami selalu menjalankan setiap perubahan signifikan dalam produk untuk diri kami sendiri. Basis pengetahuan tidak terkecuali. Misalnya, kami telah menyimpan catatan pertemuan mingguan kami di sana selama beberapa bulan, dan kami juga telah membuat seluruh bagian dokumentasi internal: Anda dapat menemukan rencana pelatihan untuk insinyur dukungan teknis baru, instruksi untuk melakukan pekerjaan yang dijadwalkan pada server cloud dan rekomendasi untuk pergi berlibur.

gambar

Banyak fitur dan koreksi diimplementasikan tepat di belakang pengalaman kami: sesuatu yang tampak nyaman pada tata letak ternyata sangat tidak nyaman untuk digunakan, atau kami merasa bahwa beberapa fungsionalitas hilang. Dan pada malam sebelum perilisan genre klasik, kami menemukan bug yang agak serius dan berhasil memperbaikinya dengan upaya tim gabungan.

Apakah ada hal lain yang menarik?


Tentu saja, basis pengetahuan bukan satu-satunya peningkatan di YouTrack 2020.2.

Administrator proyek sekarang dapat mengatur grup pengguna yang akan melihat tugas-tugas dalam proyek secara default - untuk skenario ini, Anda tidak perlu lagi menulis kode. Selain itu, kami telah memperluas daftar jenis bidang yang dapat dikonversi ke jenis lain: misalnya, bidang teks dapat dikonversi ke bidang string, dan bidang status dapat dikonversi ke yang disebutkan untuk menghindari konflik beberapa bidang status.

Untuk pekerjaan yang produktif dengan kolega dari tim lain, Anda dapat berbagi tag, pencarian tersimpan, papan Agile dan laporan dengan cara baru yang lebih fleksibel, yaitu untuk berbagi dengan beberapa grup pengguna sekaligus.

Kami juga menambahkan pengaturan baru untuk ruang kerja dan daftar tugas, serta tindakan "Mengkloning tugas sebagai konsep". Bagi mereka yang baru mulai bekerja dengan papan Agile, kami telah menyederhanakan proses pembuatan papan sebanyak mungkin. Baca lebih lanjut tentang semua inovasi di blog kami .

All Articles