Jira ve Confluence'ı birlikte çalıştırmak: sayfadan iş açma, makro ve sürüm notu

İki aracı neden birlikte çalıştırırız?

Jira işi takip eder: kim neyi yapıyor, hangi durumda, ne zaman bitecek. Confluence bilgiyi tutar: neden bu işi yapıyoruz, gereksinim ne, karar nasıl alındı. İki araç ayrı kullanıldığında bilgi kopar. Gereksinim sayfasında yazanla Jira'daki iş öğeleri farklılaşır, sürüm notu elle yazılır, karar gerekçesine kimse ulaşamaz.

Entegrasyonun amacı bu kopukluğu gidermektir: gereksinim sayfasından doğrudan iş açmak, sayfada işlerin canlı durumunu göstermek ve işlerden sürüm notu çıkarmak. İki aracın hangi işleri paylaştığı karşılaştırma sayfasında, Confluence'ın tek başına kullanımı ise ayrı bir beceri sayfasında anlatılır. Bu sayfa ikisini birbirine bağlamanın pratik yollarına odaklanır.

Atlassian belgeleri iki aracı birlikte kullanmanın birkaç yolunu sayar: sayfa metninden iş öğesi oluşturma, Jira makrosuyla iş öğelerini sayfada gösterme, ürün gereksinimleri şablonu, Jira raporu ve grafik makroları, yol haritası makrosu. Bu yöntemlerin çoğu iki ürünün birbirine bağlı olmasını ve kullanıcının her iki tarafta yetkisini gerektirir.

Gereksinim sayfasından iş açmak

Confluence sayfasındaki bir metin parçasını seçtiğinizde, araç çubuğundaki Jira iş öğesi seçeneğiyle o metinden iş oluşturabilirsiniz. Tek bir iş için tek öğe seçeneği, bir tablodaki birçok satırdan toplu iş açmak için çoklu seçenek vardır. Açılan panelde Jira alanları doldurulur ve oluşan iş sayfaya bağlantı olarak eklenir. Atlassian ayrıca yapay zeka ile özet ve açıklama taslağı öneren bir seçenek de sunar; bu özellik kapatılabilir ve çıktısı mutlaka gözden geçirilmelidir.

Ürün gereksinimleri şablonu bu akışı yapılandırır: sayfadaki yer tutucu bağlantıdan bir epik oluşturulur, ardından gereksinim maddeleri seçilerek bağlı hikâyeler açılır. Böylece sayfadaki her gereksinimin Jira'da bir karşılığı olur ve iki taraf birbirine bağlanır.

Bu akışın iyi çalışması için gereksinim maddeleri tek tek, ölçülebilir ve bağımsız yazılmalıdır. Uzun bir paragraftan tek bir iş çıkarmak, işi izlemeyi zorlaştırır. Sayfa yazarken madde başına bir iş öğesi düşünün.

Jira makrosu: sayfada canlı iş durumu

Jira iş öğeleri makrosu, sayfada tek bir iş öğesini, filtrelenmiş bir iş listesini ya da bir sayımı gösterir. Makro editörden eklenebilir; Jira iş öğesinin bağlantısını sayfaya yapıştırdığınızda da Confluence bunu otomatik olarak makroya çevirir. Liste için JQL sorgusu verilebilir. Sayfa açıldığında iş durumları Jira'dan güncel olarak çekilir.

Bu, durum toplantısı sayfaları için çok işe yarar: statik bir tablo yerine "bu sürümün açık işleri" sorgusunu gösteren bir makro, her ziyarette güncel kalır. Aynı şekilde bir gereksinim sayfasında maddenin yanında bağlı işin durumu görünür.

Makroda yapılacak seçimler önemlidir. Çok geniş bir sorgu sayfayı yavaşlatır ve okunmaz hale getirir; makro yalnızca sayfanın konusuyla ilgili işleri göstermelidir. Gösterilecek sütunlar da dar tutulmalıdır: iş anahtarı, özet, durum ve atanan yeterlidir. Jira grafik makrosu ise aynı veriyi grafik olarak gösterir.

Sürüm notu ve durum raporu sayfaları

Sürüm notunu elle yazmak, hem zaman alır hem de eksik kalır. Confluence'ın Jira raporu şablonu, Jira verisinden değişiklik günlüğü ya da durum raporu sayfası üretir. Böylece belirli bir sürümde tamamlanan işler listelenir ve sayfa bu veriden doldurulur. Üretilen sayfa bir taslaktır: başlıklar, müşteri diline çevrilen açıklamalar ve önemli notlar insan eliyle düzenlenmelidir.

İyi bir sürüm notu sayfasının üç özelliği vardır. İş anahtarlarıyla izlenebilir olmalıdır, böylece her madde Jira'ya geri bağlanır. Okuyucunun diliyle yazılmalıdır, çünkü iş özetleri çoğunlukla geliştirici diliyle yazılmıştır. Ve tek bir yerde durmalıdır; sürüm notları için ayrı bir alan açmak arama ve gezinmeyi kolaylaştırır.

Sprint döngüsünde toplantı notu ve retrospektif şablonları da Jira ile bağlanabilir: sprint planlama sayfası sprinte bağlanır, retrospektif sayfasında sprintin işleri görünür. Bu bağ, ekibin neyi neden yaptığına dair hafızayı canlı tutar.

Adım adım: ilk entegrasyonu kurmak

Önce iki aracın aynı Atlassian sitesinde bağlı olduğundan ve ilgili kullanıcıların her iki tarafta da yetkisi bulunduğundan emin olun. Yetkisi olmayan bir kullanıcı makroda iş detayını göremez ya da iş oluşturamaz; bu en yaygın "çalışmıyor" şikâyetinin nedenidir.

Sonra küçük bir pilot seçin: yaklaşan bir özellik için bir gereksinim sayfası yazın. Maddeleri yazın, sayfadan epik ve hikâyeleri açın, durum makrosunu ekleyin. Sürüm sonunda aynı pilot için bir sürüm notu sayfası üretin. Bu tek döngü, ekibin neyin işe yaradığını ve hangi alışkanlıkların gerektiğini görmesini sağlar.

Son adım ekip kuralıdır: gereksinim sayfası kaynak mıdır, Jira işi mi? Çoğu ekip için amaç ve bağlam sayfada, iş ve durum Jira'dadır. İki yerde aynı şeyi yazmamak, güncellik sorununun yarısını çözer.

Sık yapılan hatalar

En sık hata, durumu sayfaya elle yazmaktır. Makro yerine kopyalanmış bir tablo hemen eskir. İkinci hata, çok geniş bir JQL sorgusunu makroya koymaktır; sayfa yavaşlar ve okuyucu aradığını bulamaz.

Üçüncü hata, iş öğelerini sayfaya bağlamadan açmaktır. Sonradan hangi işin hangi gereksinimden doğduğunu bulmak zorlaşır. Dördüncü hata, kimin neyi güncellediğini belirlememektir: sayfa sahipsizse eskir.

Beşinci hata, otomatik üretilen sürüm notunu düzenlemeden yayımlamaktır; geliştirici diliyle yazılmış satırlar müşteri için anlamsız olabilir.

Bu beceriyi Mindset programlarında nerede çalışırsınız

Jira Eğitimi: Temel ve İleri Uygulama programındaki Jira'yı diğer araçlarla entegrasyon ve ileri özellikler başlığı, bu sayfadaki bağlantıların temelini oluşturur; backlog yönetimi, sprint işleyişi ve gerçek zamanlı izleme ve raporlama başlıkları ise Confluence'a taşınacak verinin kaynağını anlatır. Ürün sahipleri, proje yöneticileri ve Jira yöneticileri için uygundur.

Uygulamada menü adları ve şablonlar zamanla değişebilir; güncel adımlar için Atlassian belgelerine bakmak gerekir.