Lihat bagaimana pelanggan RS21 dan tim teknik Guru sendiri menggunakan Guru untuk mempersiapkan dokumentasi pengembangan mereka untuk masa depan, termasuk proses dan template.
Semua tim teknik bergantung pada semacam alat dokumentasi untuk berkomunikasi informasi produk penting dengan rekan-rekan mereka. Untuk tim kecil yang baru memulai, ini bisa sesederhana Google Doc, dan untuk tim yang lebih besar dengan produk yang kompleks, ini bisa menjadi wiki hierarkis. Tergantung pada bagaimana perusahaan mereka terstruktur, tim lain (seperti HR atau pemasaran) juga dapat menggunakan wiki ini, atau memiliki area lain di mana mereka menyimpan informasi tim mereka.
Ketika bergabung dengan tim teknik baru (baik secara internal maupun eksternal), proses penyerahan sangat penting untuk menentukan seberapa cepat rekan baru merasa siap untuk berkontribusi. Dari menyiapkan lingkungan pengkodean mereka hingga meneliti dokumentasi fitur, ada banyak yang diperlukan untuk mempersiapkan dan siap untuk mengambil pekerjaan baru.
Untuk banyak tim teknik, proses penyerahan ternyata menjadi melelahkan bagi rekan lain, yang ditunjuk sebagai "teman" karyawan baru dan akan membimbing mereka melalui informasi ini secara langsung. Namun, dengan menyediakan tim mereka dengan Kartu yang telah diverifikasi oleh ahli dan terkini di Guru, pemimpin teknik RS21 memberikan karyawan baru fleksibilitas untuk penyerahan sesuai dengan kecepatan mereka sendiri. Ini memungkinkan mereka menghemat waktu dengan "teman" penyerahan mereka untuk membangun hubungan interpersonal yang lebih baik atau pertanyaan yang belum terjawab.
Ketika seorang insinyur baru bergabung dengan tim RS21, mereka masuk ke Guru untuk mulai mempelajari materi penyerahan. Mereka akan melihat "Papan Info Tim" di mana mereka bisa mengenal sedikit tentang rekan-rekan mereka, menggunakan Kartu infrastruktur untuk menyiapkan lingkungan mereka dengan benar, dan membaca standar pengkodean tim mereka untuk mendapat ide tentang bagaimana berkolaborasi dengan rekan baru mereka.
Begitu pula, di Guru, ketika seorang insinyur bergabung atau pindah ke tim baru, penyerahan mereka dilakukan di Guru. Mereka akan menggunakan Kartu cerita kehidupan untuk mengenal rekan-rekan mereka, melihat panduan tentang bagaimana mereka seharusnya bekerja sama, dan menjelajahi Koleksi tim baru mereka di Guru untuk menjadi akrab dengan fitur produk dan area yang kini menjadi tanggung jawab mereka.
Praktik Terbaik dan Standar Tim
Setelah seluruh tim dilakukan penyerahan, sumber daya berkelanjutan, seperti standar pengkodean dan praktik terbaik dokumentasi, juga memiliki tempat di Guru. Ketika didokumentasikan dengan cara yang dapat diakses dalam alur kerja mereka, ini memudahkan insinyur untuk berkolaborasi secara produktif dengan sisa tim mereka dan sisa perusahaan. Ini juga mencegah mereka harus menghafal kebijakan atau prosedur apa pun atau lebih buruk, menandai dan bergantung pada dokumen yang sudah ketinggalan zaman.
Koleksi Teknik RS21 di Guru mencakup sebuah Papan yang didedikasikan untuk pedoman proses, termasuk Kartu dengan instruksi untuk menggabungkan kode, membuat skrip bash, meminta tinjauan kode, dan lainnya. Mereka juga memiliki Papan yang didedikasikan untuk gaya sintaks pengkodean yang disetujui tim, instruksi penyiapan AWS, informasi Admin Sistem, dan lainnya. Mereka bahkan memiliki potongan kode yang sering digunakan tersedia untuk disalin dan ditempel dengan mudah di Kartu Guru.
Selain Kartu khusus teknik ini, Guru juga merupakan tempat yang bagus bagi para insinyur untuk mengakses praktik terbaik lintas fungsi dan pedoman untuk proses antar tim. Sebagai contoh, tim RS21 melakukan diskusi asinkron menggunakan Guru untuk memberi anggota tim lebih banyak waktu untuk merespons dengan bijak, dan untuk memberi semua orang platform yang adil untuk berkontribusi. Instruksi tentang cara menyiapkan dan memantau diskusi ini disimpan dalam template Guru, sehingga siapa saja dapat dengan mudah mengaturnya ketika diperlukan.
Di Guru, kami mengajak tim di luar organisasi pengembangan produk kami untuk membantu dengan proses jaminan kualitas (QA) kami. Dengan pandangan yang lebih beragam, kami lebih mampu mengidentifikasi bug, mengeksplorasi tantangan pelanggan yang mungkin muncul, dan melindungi diri dari mereka sebelum rilis. Namun, proses yang sedemikian teknis seperti QA memerlukan instruksi dan prosedur yang didokumentasikan saat melibatkan tim lintas fungsi. Sebelum memulai QA untuk fitur baru, seorang pemimpin tim teknik akan menggunakan template Proses QA untuk membuat satu tempat untuk semua yang akan dibutuhkan tim kami dan pemangku kepentingan untuk QA end-to-end. Ketika kami siap untuk memulai QA, mereka akan mengirimkan ini sebagai pengumuman kepada tim dan pemangku kepentingan, dan menyertakan tanggal aktif QA dalam pesan tersebut.
Perencanaan Proyek dan Dokumentasi Pengembangan
Setiap kali proyek pengembangan baru dimulai, ada banyak dokumentasi yang menyusul untuk memastikan semua orang memiliki konteks penuh yang mereka butuhkan untuk melaksanakan peran mereka. Setelah rapat kick-off, para insinyur mengandalkan dokumen persyaratan dari tim produk, desain fungsional terbaru dari tim UX mereka, salinan dari tim pemasaran atau penulisan salinan mereka, dan lainnya.
Dan, tentunya, mereka akan sering perlu merujuk pada dokumentasi teknis yang berdampak pada fitur yang sedang mereka kerjakan, atau yang perlu mereka perbarui nanti dalam pengembangan.
Di Guru, kami melacak berbagai sumber daya yang diperlukan untuk pengembangan produk dalam Kartu Sumber Daya Proyek Aktif, yang dipimpin oleh masing-masing pemimpin teknik proyek. Kartu ini adalah sumber daya utama tim teknik sepanjang tahap awal dari siklus hidup pengembangan produk, dan diperbarui untuk mencerminkan setiap perubahan yang terjadi.
Saat proses pengembangan berlangsung, kolaborasi antara teknik dan desain harus tetap sejalan. Namun karena sifat pekerjaan yang sering asinkron dan jarak jauh, para desainer dan insinyur tidak selalu dapat ikut serta dalam panggilan Zoom untuk membahas masalah atau umpan balik. Untuk memastikan mereka mengikuti protokol internal yang disepakati untuk meminta umpan balik desain, tim teknik kami menggunakan Umpan Balik Desain untuk perubahan UI yang didokumentasikan di Guru.
Dokumentasi yang Siap untuk Masa Depan
Dokumentasi selalu menjadi dan akan selalu menjadi bagian yang diperlukan dari pekerjaan seorang insinyur. Tetapi apa yang dulunya mengundang keluhan menyakitkan dan desahan putus asa dapat menjadi bagian yang sederhana dan alami dari hari-hari mereka ketika langsung dibawa ke dalam alur kerja mereka. Ekstensi peramban Guru membawa dokumentasi langsung ke tempat yang dibutuhkan insinyur, bukannya memaksa mereka untuk beralih konteks untuk mengaksesnya, dan Kartu yang diverifikasi oleh ahli dengan format singkat mengurangi tekanan dari artikel panjang yang dahulu menyulitkan untuk ditulis dan bahkan lebih sulit untuk dipelihara. Jadi kenapa menambah utang teknis dengan dokumentasi usang ketika Anda bisa dengan mudah memperbaruinya sekarang juga? Mulai hari ini secara gratis.
Semua tim teknik bergantung pada semacam alat dokumentasi untuk berkomunikasi informasi produk penting dengan rekan-rekan mereka. Untuk tim kecil yang baru memulai, ini bisa sesederhana Google Doc, dan untuk tim yang lebih besar dengan produk yang kompleks, ini bisa menjadi wiki hierarkis. Tergantung pada bagaimana perusahaan mereka terstruktur, tim lain (seperti HR atau pemasaran) juga dapat menggunakan wiki ini, atau memiliki area lain di mana mereka menyimpan informasi tim mereka.
Ketika bergabung dengan tim teknik baru (baik secara internal maupun eksternal), proses penyerahan sangat penting untuk menentukan seberapa cepat rekan baru merasa siap untuk berkontribusi. Dari menyiapkan lingkungan pengkodean mereka hingga meneliti dokumentasi fitur, ada banyak yang diperlukan untuk mempersiapkan dan siap untuk mengambil pekerjaan baru.
Untuk banyak tim teknik, proses penyerahan ternyata menjadi melelahkan bagi rekan lain, yang ditunjuk sebagai "teman" karyawan baru dan akan membimbing mereka melalui informasi ini secara langsung. Namun, dengan menyediakan tim mereka dengan Kartu yang telah diverifikasi oleh ahli dan terkini di Guru, pemimpin teknik RS21 memberikan karyawan baru fleksibilitas untuk penyerahan sesuai dengan kecepatan mereka sendiri. Ini memungkinkan mereka menghemat waktu dengan "teman" penyerahan mereka untuk membangun hubungan interpersonal yang lebih baik atau pertanyaan yang belum terjawab.
Ketika seorang insinyur baru bergabung dengan tim RS21, mereka masuk ke Guru untuk mulai mempelajari materi penyerahan. Mereka akan melihat "Papan Info Tim" di mana mereka bisa mengenal sedikit tentang rekan-rekan mereka, menggunakan Kartu infrastruktur untuk menyiapkan lingkungan mereka dengan benar, dan membaca standar pengkodean tim mereka untuk mendapat ide tentang bagaimana berkolaborasi dengan rekan baru mereka.
Begitu pula, di Guru, ketika seorang insinyur bergabung atau pindah ke tim baru, penyerahan mereka dilakukan di Guru. Mereka akan menggunakan Kartu cerita kehidupan untuk mengenal rekan-rekan mereka, melihat panduan tentang bagaimana mereka seharusnya bekerja sama, dan menjelajahi Koleksi tim baru mereka di Guru untuk menjadi akrab dengan fitur produk dan area yang kini menjadi tanggung jawab mereka.
Praktik Terbaik dan Standar Tim
Setelah seluruh tim dilakukan penyerahan, sumber daya berkelanjutan, seperti standar pengkodean dan praktik terbaik dokumentasi, juga memiliki tempat di Guru. Ketika didokumentasikan dengan cara yang dapat diakses dalam alur kerja mereka, ini memudahkan insinyur untuk berkolaborasi secara produktif dengan sisa tim mereka dan sisa perusahaan. Ini juga mencegah mereka harus menghafal kebijakan atau prosedur apa pun atau lebih buruk, menandai dan bergantung pada dokumen yang sudah ketinggalan zaman.
Koleksi Teknik RS21 di Guru mencakup sebuah Papan yang didedikasikan untuk pedoman proses, termasuk Kartu dengan instruksi untuk menggabungkan kode, membuat skrip bash, meminta tinjauan kode, dan lainnya. Mereka juga memiliki Papan yang didedikasikan untuk gaya sintaks pengkodean yang disetujui tim, instruksi penyiapan AWS, informasi Admin Sistem, dan lainnya. Mereka bahkan memiliki potongan kode yang sering digunakan tersedia untuk disalin dan ditempel dengan mudah di Kartu Guru.
Selain Kartu khusus teknik ini, Guru juga merupakan tempat yang bagus bagi para insinyur untuk mengakses praktik terbaik lintas fungsi dan pedoman untuk proses antar tim. Sebagai contoh, tim RS21 melakukan diskusi asinkron menggunakan Guru untuk memberi anggota tim lebih banyak waktu untuk merespons dengan bijak, dan untuk memberi semua orang platform yang adil untuk berkontribusi. Instruksi tentang cara menyiapkan dan memantau diskusi ini disimpan dalam template Guru, sehingga siapa saja dapat dengan mudah mengaturnya ketika diperlukan.
Di Guru, kami mengajak tim di luar organisasi pengembangan produk kami untuk membantu dengan proses jaminan kualitas (QA) kami. Dengan pandangan yang lebih beragam, kami lebih mampu mengidentifikasi bug, mengeksplorasi tantangan pelanggan yang mungkin muncul, dan melindungi diri dari mereka sebelum rilis. Namun, proses yang sedemikian teknis seperti QA memerlukan instruksi dan prosedur yang didokumentasikan saat melibatkan tim lintas fungsi. Sebelum memulai QA untuk fitur baru, seorang pemimpin tim teknik akan menggunakan template Proses QA untuk membuat satu tempat untuk semua yang akan dibutuhkan tim kami dan pemangku kepentingan untuk QA end-to-end. Ketika kami siap untuk memulai QA, mereka akan mengirimkan ini sebagai pengumuman kepada tim dan pemangku kepentingan, dan menyertakan tanggal aktif QA dalam pesan tersebut.
Perencanaan Proyek dan Dokumentasi Pengembangan
Setiap kali proyek pengembangan baru dimulai, ada banyak dokumentasi yang menyusul untuk memastikan semua orang memiliki konteks penuh yang mereka butuhkan untuk melaksanakan peran mereka. Setelah rapat kick-off, para insinyur mengandalkan dokumen persyaratan dari tim produk, desain fungsional terbaru dari tim UX mereka, salinan dari tim pemasaran atau penulisan salinan mereka, dan lainnya.
Dan, tentunya, mereka akan sering perlu merujuk pada dokumentasi teknis yang berdampak pada fitur yang sedang mereka kerjakan, atau yang perlu mereka perbarui nanti dalam pengembangan.
Di Guru, kami melacak berbagai sumber daya yang diperlukan untuk pengembangan produk dalam Kartu Sumber Daya Proyek Aktif, yang dipimpin oleh masing-masing pemimpin teknik proyek. Kartu ini adalah sumber daya utama tim teknik sepanjang tahap awal dari siklus hidup pengembangan produk, dan diperbarui untuk mencerminkan setiap perubahan yang terjadi.
Saat proses pengembangan berlangsung, kolaborasi antara teknik dan desain harus tetap sejalan. Namun karena sifat pekerjaan yang sering asinkron dan jarak jauh, para desainer dan insinyur tidak selalu dapat ikut serta dalam panggilan Zoom untuk membahas masalah atau umpan balik. Untuk memastikan mereka mengikuti protokol internal yang disepakati untuk meminta umpan balik desain, tim teknik kami menggunakan Umpan Balik Desain untuk perubahan UI yang didokumentasikan di Guru.
Dokumentasi yang Siap untuk Masa Depan
Dokumentasi selalu menjadi dan akan selalu menjadi bagian yang diperlukan dari pekerjaan seorang insinyur. Tetapi apa yang dulunya mengundang keluhan menyakitkan dan desahan putus asa dapat menjadi bagian yang sederhana dan alami dari hari-hari mereka ketika langsung dibawa ke dalam alur kerja mereka. Ekstensi peramban Guru membawa dokumentasi langsung ke tempat yang dibutuhkan insinyur, bukannya memaksa mereka untuk beralih konteks untuk mengaksesnya, dan Kartu yang diverifikasi oleh ahli dengan format singkat mengurangi tekanan dari artikel panjang yang dahulu menyulitkan untuk ditulis dan bahkan lebih sulit untuk dipelihara. Jadi kenapa menambah utang teknis dengan dokumentasi usang ketika Anda bisa dengan mudah memperbaruinya sekarang juga? Mulai hari ini secara gratis.
Alami kekuatan platform Guru secara langsung - ikuti tur produk interaktif kami
.webp)
