Bagaimana untuk mewujudkan pertukaran pengetahuan dalam syarikat supaya ia tidak terlalu menyakitkan

Rata-rata syarikat IT mempunyai keperluan, sejarah penjejak tugas, sumber (mungkin juga dengan komen dalam kod), arahan untuk kes tipikal, penting dan kompleks dalam pengeluaran, penerangan proses perniagaan (dari onboarding kepada "bagaimana untuk pergi bercuti ”), kenalan, kunci akses, senarai orang dan projek, perihalan bidang tanggungjawab - dan sekumpulan pengetahuan lain yang kita mungkin terlupa dan boleh disimpan di tempat yang paling menakjubkan.

Pengetahuan =/= dokumentasi. Ini tidak boleh dijelaskan, ia mesti diingat

Bagaimana untuk memastikan bahawa mereka yang perlu mengetahui sesuatu daripada ini memahami di mana dan cara mencarinya, dan setiap orang yang perlu mengetahui perkara dan perjanjian individu boleh mengetahui dengan serta-merta dan tepat tentang perubahan padanya.

Dalam episod akhir podcast "Team Lead Will Call", lelaki dari Skyeng bercakap tentang pengurusan pengetahuan dengan Igor mungkin-kucing Tsupko ialah ahli jawatankuasa program KnowledgeConf dan "pengarah yang tidak diketahui" di Flant.

Rakaman penuh tersedia sebagai Video YouTube, dan di bawah kami telah mengumpulkan beberapa petua dan pautan menarik kepada bahan berguna yang disebut dalam audio atau mengembangkan maklumat daripadanya. Alangkah baiknya jika anda turut berkongsi godaman dan helah pasukan anda dalam ulasan.

Peretasan pertama: anda tidak perlu lagi mengetahui sistem mana yang hendak dilihat

“Saya mengambil sumber pengetahuan kami dan membuat carian umum untuknya: satu tetingkap dengan sistem penapisan untuk mengurangkan kawasan carian. Ya, pada masa yang sama, anda masih perlu memantau kualitinya, menambah pangkalan pengetahuan dan memerangi pertindihan dan maklumat yang salah.

Sekeping kertas untuk mencari itu sahaja

Tetapi sudah, kira-kira 60% jurutera Flant menggunakan carian ini sekurang-kurangnya 1-2 kali sehari - dan biasanya mencari jawapan di kedudukan pertama atau kedua. Dan dalam bentuk bukti konsep ialah pengindeksan dokumen Google: semua dox, folder, pemacu van dan sebagainya - semua ini juga mudah didorong ke dalam carian dalaman."

Godam kedua: bagaimana untuk tidak terlepas perkara yang sangat penting dalam sekumpulan sembang

"Jika anda bekerja dalam pasukan yang diedarkan, maka mungkin sebahagian besar hari anda dihabiskan dalam Slack - dan dalam hal ini anda sudah biasa melakukan sesuatu seperti ini: "@myteam, bantu/lihat/masukkan yang betul... ”.” Tetapi terdapat masalah dengan banyaknya maklumat - dan sebutan berasingan boleh terlepas antara mesej lain.

Di Skyeng kami dibantu oleh bot yang melaluinya anda boleh menulis mesej dan menandakan sebarang bilangan orang atau kumpulan. Kami menggunakannya dalam kes yang sangat penting untuk orang membaca atau bertindak balas: ia akan mencucuk tanpa henti sehingga anda menekan butang "Saya membaca" - anda tidak akan dapat melangkau atau mengabaikannya."

Soalan untuk dijawab: apa yang perlu dilakukan dengan dokumentasi?

“Banyak pengetahuan datang daripada juruteknik, tetapi tidak semua orang tahu bagaimana untuk menerangkannya dengan baik.
Lagipun, anda tidak mempunyai sebarang pengkompil atau linter yang akan memberitahu anda sama ada anda melakukannya dengan betul atau tidak - dan selalunya output yang kami ada adalah tidak dapat difahami, teks yang tidak diformatkan dengan baik dan tidak lengkap. Sudah tentu, anda perlu melakukannya secara normal, bukan kerana seseorang datang dan berkata "ia perlu" - anda melakukannya dengan baik untuk diri sendiri: dalam satu atau dua bulan anda akan membacanya dan memahaminya. Dan orang lain, membuka dokumen, tidak akan segera menutupnya selama-lamanya, menyedari bahawa ia tidak berguna.

Sebahagian daripada podcast khusus untuk soalan "Berapa ramai orang yang diperlukan untuk menulis dokumentasi yang baik atau membuat demo biasa"

Tetapi persoalannya tetap: berapa banyak masa untuk diperuntukkan untuk ini dan bagaimana untuk melakukannya dengan cekap?
Dan jika ada jawapan jujur ​​di sini: melainkan ahli perniagaan terlibat, dan melainkan mereka mengalami kesan dokumentasi yang baik secara empirikal, terdapat risiko bahawa usaha itu akan menghasilkan sedikit pulangan. Ini lebih kepada cerita tentang perubahan budaya.

Selebihnya, pengalaman dan bimbingan akan menyelamatkan anda. Analog pengaturcaraan pasangan, penjejakan kemajuan dan ulasan kod mungkin sesuai di sini - menunjukkan amalan terbaik, mencucuk kesilapan dan membosankan pada akhirnya."

Bonus: "Baiklah, saya akan beritahu mereka dengan cara ini, mereka akan faham"

Persoalan "berapa banyak masa untuk dibelanjakan untuk ini dan pada tahap apa untuk melakukannya" adalah penting bukan sahaja dalam rangka kerja dokumentasi, tetapi secara umum untuk pemindahan apa-apa pengetahuan. Demo juga merupakan contoh yang bagus untuk berkongsi maklumat. Tetapi ada nuansa: sebagai contoh, bagaimana untuk memastikan bahawa mereka mengambil masa yang minimum.

Saluran perkongsian pengetahuan antara pembangunan: laporan dalaman, buku berguna, artikel, dsb. Ekstrak berstruktur juga disimpan dalam Notion.

Sebahagiannya, masalah ini boleh diselesaikan dengan amalan laporan dalaman. Sekali seminggu, 40-60 minit diambil pada masa yang kurang sibuk - dan mereka membuat laporan video untuk rakan sekerja dari projek yang berbeza. Pasukan bahagian hadapan produk utama - Vimbox - memberitahu tentang kit UI anda, yang boleh bertemakan untuk sebarang projek lain. Pasukan pembangunan pemasaran bercakap tentang perpustakaan untuk mengesan dan mencatat permintaan, yang segera menarik minat beberapa projek lain. Pasukan projek Matematik berkongsi pengalaman mereka bertukar daripada REST API kepada GraphQL. Pasukan pelajaran kumpulan sedang memikirkan untuk berkongsi bagaimana mereka menjadi orang pertama yang beralih kepada PHP 7.4. Dan sebagainya.

Senarai ini telah dikekalkan sejak Mei 2018 dan mempunyai lebih 120 penyertaan

Semua mesyuarat dimulakan melalui Google Meet korporat, direkodkan dan dalam masa 1.5 jam muncul dalam folder pada pemacu Google kongsi dan pautan ke rakaman diduplikasi dalam Slack yang sama. Iaitu, anda tidak perlu datang jika ada kecemasan, tetapi tontonnya kemudian pada kelajuan 20 - biasanya laporan itu sendiri berlangsung sehingga XNUMX minit, dan perbincangan - bagaimana hasilnya. Tetapi kami tidak melampaui masa itu)

PS Apa yang berkesan dan tidak berkesan untuk anda?

Pautan yang berguna:

• Rodion Nagornov dari Kaspersky Lab tentang apakah itu pengurusan pengetahuan dan mengapa ini bukan dokumentasi (terima kasih kepada saluran Igor untuk pautan itu “Neraka IT yang selesa”, terdapat banyak lagi seperti itu).

• Igor Tsupko dari Flant tentang itu bagaimana untuk melaksanakan pengurusan pengetahuan dalam syarikat saya

• Alexey Kataev dari Skyeng tentang cara memantau dan meratakan faktor bass (jurang pengetahuan dalam teknologi dan bidang tertentu) dalam pasukan yang diedarkan.

• Sergey Goncharuk dari Flant tentang menyampaikan maklumat - bagaimana untuk mengetahui bila dan siapa yang perlu ditanya, jika anda menghadapi masalah dalam pasukan yang diedarkan.

Sumber: www.habr.com