Yeni işe alımlar için daha iyi bir yol [kapalı]

Şu anda ekip, üyeler genellikle aynı şirket içinde farklı projelere geçerek oldukça yüksek bir ciro deneyiminin parçasıyım. Şu anda yeni üyeler için "eğitimimiz", onları uygulamalı deneyim sağlayacak ve daha yeni çalışanların mentordan bir şey isteyip istemediğini soracak olan daha üst düzey geliştiricilere soracak olan birincil bir kişiyle (genellikle eğitimlerini tamamlamak için en son kişi) eşleştirmektir. bilmiyor. Yeni işe alımın hızlı bir şekilde dahil olmasını sağlar ve mentoru da sistem hakkındaki anlayışını geliştirmeye zorlar.

Ancak, tahmin edebileceğiniz gibi, bu eğitim tarzı çok zaman alıcıdır ve çok iyi bir bilgi aktarımı sağlamaz (kavram yanılgıları yayılır, boşluklar genişler).

Gelecekteki yeni işe alımlarımız için dokümantasyon ve eğitim materyalleri oluşturmakla görevlendirildim. Zaten ara sıra teknik yazma yapıyorum, ancak son kullanıcı için ve çok sayıda ekran görüntüsü ile son derece spesifik ve tamamlanması için çok zaman harcıyor.

Yeni işe alımlar için yeni dokümantasyonun oluşturulması düşük önceliklidir ve şu anda üzerinde çalışmak için sadece ~ 40 saatim var. Sistemi teknik belgelere yazdığım şekilde belgelemek, yüzeyi 40 saat içinde zorlukla çizebilir. Özellikle sadece kod tabanı hakkında değil, aynı zamanda dağıtımlar ve destek hakkında da belgelemek zorunda olduğumu düşünüyoruz.

Yeni işe alımları mümkün olduğunca çabuk güncellemek için belgeleri yazmak için önemli zaman harcamadan belgeleri nasıl hızlı bir şekilde yazabilirim?

Ek Bilgi:
Şu anda hem bir wiki hem de bazı eğitim belgelerine sahibiz, ancak her ikisi de seyrek.

İyi soru. İşbaşı programcılığı eğitimi çok nadiren ciddiye alınmaz, ne de sık sık konuşulur.

Gördüğüm bazı fikirler iyi çalışıyor:

• Wiki'nizde, yeni bir işe alınan rampup belgesine (yazdığınız belge) sahip olun. Bu belgede, yeni kiralamanın ilk 1-2 hafta boyunca yerine getireceği görevleri açıklayın. Çalıştığım yerde, dahili yazılım / araçlardan süreçlere, belirli bilgi türlerinin bulunduğu yerlere kadar her şeyden haberdar olacak çok şey var. edit> yapılandırma vb ekran görüntüleri ile "x, y, z sırayla yükleyin" gibi talimatlar var. Yani Win Server, SQL Server, SharePoint, BizTalk ile bir sistem veya çiftlik (VM) yapılandırmak, bizim yazılım kadar basit değil sesler. Bu, desteklediğimiz uygulamaların diğer sürümleri için geçerlidir.
• Uygulama problemleri. Neredeyim, büyük ish API'sini ortaya çıkaran bir ürünümüz var. Bu nedenle, tıpkı müşterilerimiz / müşterilerimiz gibi, uzantıları (önceden belirlenmiş) yazmak için kendi ürün dokümantasyonumuzu incelemek her zaman faydalıdır. Dolayısıyla, ürününüzün API'sının bir parçası olarak bir matematik kitaplığınız varsa, "API'mızı kullanarak bir hesap makinesi yazın" veya bunun gibi bir şey olan bir uygulama sorununa sahip olun.
• Akıl hocaları iyidir. Onları sakla. Bunu burada da yapıyoruz ve sadece insanlarla tanışmak / arkadaş edinmek için iyi bir yol değil, aynı zamanda bir öğrenme kaynağı olarak çok değerli. Başkasının yapabileceği kurumsal bilgi geçmişine sahip olmadıkları için eğitimi bitiren en yeni kişi olmamasını öneriyorum . Herkesin bir rotasyon yapmasını sağlayın.
• Haftalık (yaklaşık) haftalık sunumlar / teknoloji görüşmeleri yapıyoruz. Yeni işe alımların ürününüzden bir şeyler seçmesini (veya atamasını) ve 3. haftalarından sonra bir sunum yapmasını sağlayın. Yanlış olmaları için yer olduğunu bildiklerinden emin olun ve sunumda herhangi bir şey alırlarsa ekip bunları düzeltebilir.
• Yeni işe alımların başladığında dokümantasyon üzerinde çalışmasını sağlayın. Onları okumaya zorlar.

Dan McGrath'ın belirttiği gibi, yeni işe alımları wiki'yi onlar için geliştirmeye teşvik etmek iyi bir fikirdir.

İlk olarak, yeni işe alım eğitim belgenizi bir müşteri için yazacağınız bir şey kadar ayrıntılı hale getirmenize gerek olmadığını öneririm. Yeni bir geliştiricinin rehber olarak kullanabilmesi için yeterince teknik olması gerekir, ancak her küçük şeyi özetleyecek kadar ayrıntılı değildir. Sonuçta soruları olursa ekiple konuşabilecekler.

Yeni işe alınanların ekibinize faydalı olması için bilmeleri gereken ilk 10 şey nedir? Bunlara konsantre olun. Yeni bir geliştiricinin yapmak için yeterli ve devam etmesini sağlayacak yeterli bilgiye sahip olması için onları hit listeniz yapın. Listede çok fazla şey varsa, ilk iki veya üç hafta içinde yapacaklarını kendinize sorun. Bu süre içinde bir şey yapmayacaklarsa, belki de biniş rehberinde olmamalıdır.

Rehberinizin her bölümü için, üstte vurgulanan bir kişinin bulunduğundan emin olun. Bu şekilde, yeni işe alımın herhangi bir sorusu varsa, yardım için kime gideceklerini bilirler. Ayrıca, bir ekip üyesinin çok fazla bölüm için gidilecek kişi olmadığından emin olun. Mentor değilse, bir kişinin yeni işe alım sorularına zaman ayırmak istemezsiniz.

Tüm haftanızı bu belgeye harcamayın. En az bir yeni kiralamanın geçmesine izin verdikten sonra kendiniz ayarlamak için biraz zaman ayırın. Neyin işe yaradığını, neyin işe yaramadığını ve düzeltilmesini görün.

Yakın zamanda iş yerimde benzer bir belgeye benzer zaman kısıtlamaları ile başladım. İlk başta yaptığım gibi, çok ayrıntılı bir düzeyde yazmanın kolay olduğunu vurgulamak isterim, ancak bu aslında karşı üretken olabilir.

Yeni birisi bir rolle başlıyorsa, muhtemelen ilk birkaç hafta boyunca bilgi ile su altında kalırlar. İlk eğitimlerini birkaç yıldır bir şirkette olan bir geliştiricinin beyin dökümü yapmak, aklımda, birinin bu pozisyonda ilk birkaç ay veya hatta yıl için bilmesi gerekeni çok daha karmaşık hale getirecektir. Yüksek seviyede tutun, standart jargon ve kavramları kullanmaya çalışın ve daha sonra şirketin süreçlerindeki özellikler ile genişletin.

Benim için, bu belgenin ilk tekrarı, işyerimde kullandığımız SDLC'nin, her adımda ilişkili rollerin bir listesi, bu rolleri yerine getiren insanlara birkaç örnek ve ilgili kontrol listelerinin bir taslağıdır. yaşam döngüsünün her adımı da. Kişisel olarak kontrol listelerini eğitim amaçlı değil, aynı zamanda işte yaptığım her şey için de vazgeçilmez buluyorum. Örneğin:

• Proje Yöneticisi (Joe) size Jira'da bir görev atar.
• Formül x'e göre görevin tahmini tamamlanma süresini ayarlayın.
• Üzerinde çalışmaya başladığınızda bileti 'devam ediyor' olarak ayarlayın.
• Git'ten şube oluşturun, bu ilerleme hakkında 30 saniyelik bir video izlemek için bağlantıyı tıklayın.
• Ünite testlerini tasarım belgesindeki kısıtlamalara göre yazın, ünite testi adlandırma kuralları için bkz.
• İnceleme için bilet ayarlayın ve sistemi incelemek için kod gönderin .. 'vb.

Yeni çalışanınız umarız kavramların çoğuna aşina olmalı ve şimdi süreçlerin şirkette nasıl uygulandığına dair adım adım bir rehber olmalıdır. Ayrıca, iyi yürütüldüğünü hissettiğim projelerden gerçek belgeleri kullanarak baştan sona sürecin hızlı bir demosunu yapıyorum.

Belirtildiği gibi, aynı zamanda yaşayan bir belgedir, böylece daha fazla bilgiye ihtiyaç duydukları belirlendiğinden bölümler genişletilebilir. Tüm ekip, güncelliğini korumaya dahil olmalıdır. Bu bir wiki, OneNote belgesi, her neyse, ancak tüm insanların düzenleyebileceği ve gözden geçirebileceği bir şey olabilir, daha sonra burada boş bir saat geçirdiklerinde diğer insanları iyileştirmeye dahil etmeye başlayın. Bu şekilde, bir kişi bunu yapmaz ve süreçte kendi dönüşünü tüm yeni işe alımlara yayar.

Süreci gözden geçirdikten sonra, kritik olmayan bir projede küçük bir özelliği / hata düzeltmesini takip etmelerini ve belgenin kapsamadığı soruları sormalarını sağlayın. Bu soruların ne olduğunu kaydedin, çünkü bir dahaki sefere çalıştığınızda belgeye ilk eklediğiniz şey muhtemelen olmalıdır.

Zaman harcamadan böyle iyi bir şey yapmayı birleştiremezsiniz. En azından kendin yapmak istiyorsan. Kendinize, denediğiniz kadar kesin olarak belgelendirmenin gerçekten gerekli olup olmadığını sormalısınız?

Tek alternatif, yeni işe alımların ana işi yapmasına izin vermek olacaktır. Bazı bölümleri yazsınlar. Bunları düzeltmek için harcadığınız süre (geri bildirim şeklinde) mevcut durumunuzdakinden daha az olacaktır. Bazı iyi şablonlar sağlayın ve yerleşim hakkında endişelenmenize gerek yok.

Size imkansız bir görevle hizmet ettiklerini zaten bildiğinize inanıyorum. Bir yazar olarak muhtemelen Mark Twain'den alıntıyı biliyorsunuzdur:

Daha fazla zamanım olsaydı daha az yazardım.

Hemen hemen hiçbir kaynak göz önüne alındığında, yapabileceğiniz en iyi şey bir dosya dolabı almak ve herkesten zaten sahip olduklarının bir kopyasını yapmasını ve kopyayı dosya dolabına koymasını istemektir. Bu şekilde en azından yeni işe "Sistem hakkında bir şey aramak istiyorsanız, başlanacak yer dosya dolabında" diyebilirsiniz.

İyi yazma zaman alır, dönem. Ayrıca hedef kitleye göre uyarlanması gerekir. Son kullanıcılar için işe yarayan, bir programcının ihtiyaç duyduğu şey olmayacaktır.

İyi eğitimin sadece yazılı materyallerle sınırlı olmadığından bahsetmemek gerekirse, çevrimiçi, sınıf, multimedya vb.

Dedikleri gibi, "Eğitimin pahalı olduğunu düşünüyorsanız, cehaletin maliyetini deneyin."

Ayrıca, belgelerin ilk günden itibaren sürecin ayrılmaz bir parçası olmaktan ziyade yapılacak bir şey olarak görülmesinin sistemik bir organizasyonel sorunun göstergesi olduğunu söylemeye gerek yoktur.