Yazılar: Yazılım projelerinde bilgi transferi nasıl planlanır?

İşi yapan ekip neyi devretmeli, bu ne zaman başlamalı ve gerçekleştiği nasıl anlaşılır.

Özet: Kısa yanıt

Bir Forward Deployed Engineering (FDE) çalışmasında bilgi transferi, sonda yapılan bir toplantı değildir. Bilgi transferi baştan planlanan ve iş sürerken gerçekleştirilen bir çıktıdır. Dokümantasyonu, teknik bilgiyi ve çalışma pratiklerini kapsar; gerçekleşip gerçekleşmediğini gözlenebilir işaretler gösterir.

Transfer araçtır; amaç yetkinliktir. Yetkinlik kazandırma, kurumun çözümlerini kendisinin işletip geliştirebilmesi için iç ekiplerinin, bilgisinin ve sistemlerinin güçlendirilmesidir.

Logevon, Ankara merkezli bir teknoloji danışmanlığı ve yazılım mühendisliği şirketidir. Logevon, Forward Deployed Engineering (FDE) modeliyle çalışır; bu yazı, bu modelle çalışan bir şirketin bakışıyla yazılmıştır. Yazı, Logevon'un Forward Deployed Engineering modeli içindeki kendi yöntemini anlatır; dış araştırmalara atıf yapmaz.

Tanım: Bilgi transferi nedir

Bilgi transferi

Bilgi transferi, dokümantasyonun, teknik bilginin ve çalışma pratiklerinin işi yapan ekipten müşterinin iç ekiplerine planlı biçimde devredilmesidir.

  • Dokümantasyon: sistemin ne olduğu, neden böyle geliştirildiği ve nasıl işletileceği.
  • Teknik bilgi: sistem üzerine akıl yürütebilmek, sistemi güvenle değiştirebilmek.
  • Çalışma pratikleri: değişikliklerin nasıl test edildiği, yayına alındığı ve gözden geçirildiği.

Devir teslim, bir çözümü işletme ve değiştirme sorumluluğunun işi yapan ekipten müşterinin ekibine geçtiği andır. O ana güvenle varılmasını sağlayan, bilgi transferidir.

Zamanlama: Sona bırakılan transfer neden işlemez

Logevon'a göre sona bırakılan transfer işlemez; çünkü o noktada bilgi çoktan yanlış yere yerleşmiştir.

Bilgi kişilerde kalır.

İş sırasında alınan kararlar, onları alanların kafasında durur; o kişiler de ayrılmak üzeredir.

Dokümantasyon işten kopuktur.

Sonradan yazılan dokümanlar sistemi hatırlandığı kadarıyla anlatır, arkasındaki gerekçeleri değil.

Soracak zaman kalmaz.

Asıl sorular, müşterinin ekibi sistemi değiştirmeye başladığında ortaya çıkar; son bir oturum buna yer bırakmaz.

Süreç: Her aşamada ne aktarılır

Müşterinin ekibine yalnızca beşinci aşamada değil, her aşamada bir şey geçer. Logevon'un FDE teslim modelinin altı aşaması şunlardır: Anla, Değerlendir, Tasarla, Geliştir ve Entegre Et, Yetkinleştir ve Devret, İyileştir.

  1. Anla

    Problemi ekibiniz ve Logevon mühendisleri birlikte tarif eder; böylece problem tanımının arkasındaki gerekçe baştan paylaşılır.

    Elinize geçenYazılı bir problem tanımı ve arkasındaki gerekçe.

  2. Değerlendir

    Değerlendirme ekibinizle birlikte yürütülür; ekibiniz tartılan seçenekleri ve bazılarının neden elendiğini görür.

    Elinize geçenEkibinizin açıklayabildiği yazılı bir değerlendirme.

  3. Tasarla

    Ekibiniz mimariyi ve bedellerini, geliştirme başlamadan önce gözden geçirir; devir teslim planda tanımlanır.

    Elinize geçenTemel kararları kayda geçirilmiş mimari ve teslim planı.

  4. Geliştir ve Entegre Et

    Mühendisleriniz aynı kod tabanında çalışır; kodu tanımaları kodla birlikte büyür.

    Elinize geçenEkibinizin geliştirilmesinde yer aldığı, çalışan yazılım.

  5. Yetkinleştir ve Devret

    Yol boyunca paylaşılanlar tamamlanır ve kontrol edilir: dokümantasyon bitirilir, ekibiniz çözümü biz hâlâ oradayken işletir.

    Elinize geçenMimari ve işletim dokümantasyonu; işi bizzat yapmış bir ekip.

  6. İyileştir

    Ölçümün ardından gelen değişiklikleri ekibiniz yönetir; Logevon'un işteki payı azalır.

    Elinize geçenHedefe göre ölçülmüş sonuçlar ve ekibinizin sahiplendiği bir iş listesi.

Kontrol listesi: Neler devredilir

Logevon'a göre eksiksiz bir devir teslim altı kalemi kapsar; her birinin müşteri tarafında adı belli bir sahibi vardır.

Neler devredilir
KalemNe işe yararDevir teslimden sonraki sahibi (örnek)
Mimari kararlarSistemin neden böyle geliştirildiğini açıklarTeknik lider
İşletim prosedürleriSistemi çalıştırma, izleme ve kurtarma adımlarıOperasyon ekibi
Arayüz dokümantasyonuHer entegrasyonun ne taşıdığı ve hataların nasıl ele alındığıEntegrasyonların bakımını yapan ekip
Test ve yayın süreciBir değişikliğin nasıl doğrulanıp yayına alındığıYazılım ekibi
Açık iş listesiBilinen eksikler ve sıradaki iyileştirmeler, öncelik sırasıylaÜrün ya da süreç sahibi
Erişim ve kimlik bilgileriHangi ortama, kod deposuna ve hesaba kimin erişebildiğiSistem yöneticisi

Roller örnektir; önemli olan, devir teslimden önce her kalemin adı belli bir sahibinin olmasıdır.

Gözlem: Gerçekleştiği nasıl anlaşılır

Bilgi transferi, müşterinin ekibi işi yapan ekibe ihtiyaç duymadan çalıştığında gerçekleşmiştir; bu da gözlenebilir.

Bakılacak işaretler

  • Ekip yardım almadan bir değişiklik yapıp yayına almıştır.
  • Ekip bir olayı işletim prosedürünü izleyerek çözmüştür.
  • Çalışmada yer almamış bir ekip üyesi dokümantasyonla yolunu bulabiliyor.
  • Ekip temel bir tasarım kararının neden alındığını açıklayabiliyor.
  • İşi yapan ekibe sorulan sorular azalıyor ve daha belirli hâle geliyor.

Bunlar göstergedir, garanti değildir; devir teslimden önce, bir açığı kapatmaya hâlâ zaman varken kontrol edin.

Koşullar: Bilgi transferi müşteriden ne ister

Bilgi transferi müşteriden insan, zaman ve yetki ister; bunlar yoksa bilgiyi devralacak kimse de yoktur.

  • Çözümü sahiplenecek, adı baştan belli kişiler.
  • Bu kişilerin yalnızca gözden geçirme toplantılarına girmesi için değil, işe katılması için ayrılmış zaman.
  • Sistem hakkında karar verebilmeleri için yetki.
  • Süreklilik: mümkün olduğu ölçüde, çalışma boyunca aynı kişiler.

Her teslim modelinin müşteriden neyi, ne kadar istediği Forward Deployed Engineering ve kaynak kiralama yazısında karşılaştırılır.

Sınırlar: Bilgi transferinin sınırları

Bilgi transferinin sınırları vardır ve planlama bunları ortadan kaldırmaz.

Transferin yapamadıkları

  • Her bilgi yazıya dökülemez; bir kısmı ancak birlikte çalışarak geçer.
  • Müşterinin ekibinden insanlar ayrıldığında transferin, yerlerine gelenler için yinelenmesi gerekir.
  • Logevon, gerektiğinde devir teslimden sonra da müşterisini desteklemeyi sürdürebilir; kalıcı bağımlılık iş hedefi değildir.

SSS: Bilgi transferine dair sorular

Kurum içinde yazılım ekibimiz yoksa ne olur?

Yazılım ekibi yoksa yazılımın sorumluluğunu kimin üstleneceği ve devir teslimin nasıl yapılacağı en başta kararlaştırılır. Logevon gerektiğinde müşterisini desteklemeyi sürdürebilir; kalıcı bağımlılık hedef değildir. Bu durumu Özel Yazılım Geliştirme sayfası ele alır.

Ne kadar dokümantasyon yeterlidir?

Çalışmada yer almamış birinin sistemi işletmesine ve güvenle değişiklik yapmasına yetecek kadar. Logevon'a göre bu, her kod satırının tarifi değil; kararlar ve gerekçeleri, işletim prosedürleri ve arayüzler demektir. Ölçüt kullanımdır: bir ekip üyesi dokümanı izler ve işi başarır.

Kod ve dokümanlar kimde kalır?

Müşteri, kodu, verisi ve fikrî varlıkları üzerindeki kontrolünü kararlaştırılan koşullara göre korur. Bu koşullar her çalışmanın sözleşmesinde yer alır.

Kaynaklar

Bu yazı dış kaynağa dayanmaz. Logevon'un sözlük tanımlarına, bunlardan çıkan sonuçlara ve işaretlendiği yerlerde Logevon'un kendi yöntemine ve görüşüne dayanır.