docs.microsoft.com'a Yeni Bir Geri Bildirim Sistemi Geliyor

Bu gönderi, docs.microsoft.com ekibinde Kıdemli Program Yöneticisi Rob Eisenbergtarafından yazılmıştır.

Microsoft'un misyonu, gezegendeki her bir kişiyi ve her kuruluşu daha fazlasını başarma konusunda güçlendirmektir. Bu, açık GitHub platformu üzerine docs.microsoft.com. Bugün, GitHub tabanlı yeni bir belge geri bildirim sistemine geçişle bunu bir üst düzeye taşıyoruz.

GitHub'da İçerik Geri Bildirimi

Belgelerimiz başından beri GitHub'da olsa da, içerik geri bildirim mekanizmamız makaleler hakkındaki yorumlar için Livefyre'i kullanıyor. Livefyre harika bir yorum çözümü olsa da, sahipleri izlemek, atamak ve müşteriler tarafından ortaya çıkan içerik sorunlarının durumunu korumak için belirli ihtiyaçlarımız için yetersiz olduğu ortaya çıktı.

Daha iyi hale getirmek için bir dizi yolu keşfettik, ancak çalışmalarımızın çoğunu yönlendiren bir soru yeniden ortaya çıktı: Belgelerimiz aynı açık kaynak kodu gibi ele alınsaydı, bu sorunu çözmek için ne kullanırdık? Sorunun yanıtı açıkça görülüyordu: GitHub Sorunları, bu nedenle GitHub altyapısının üzerinde tam bir geri bildirim sistemi oluşturarak GitHub API'lerini belge sayfalarımıza daha ayrıntılı bir şekilde tümleştirme denemeleri yapmaya başlamıştık.

Yeni sistemle artık doğrudan bir içerik sayfasından GitHub sorunları oluşturabilirsiniz. Bu sayede yazarlar ve ürün ekipleriyle çok daha zengin bir şekilde etkileşim kurabilirsiniz. Belgeyle ilgili bir sorun mu görüyorsunuz? Hatalı kod örneği mi? Kafa karıştırıcı bir açıklama mı? Kritik bir eksiklik mi? Sayfanın en altına kaydırın ve belge geri bildirimi seçin.

Belgeyle ilişkili tüm açık ve kapalı sorunları doğrudan belge sayfasının kendisinden görebilirsiniz; böylece her şeyin ne zaman düzeltildiğini ve çözüldüğünü her zaman bilirsiniz:

Yorum yapabilir ve hatta sizin için önemli olan sorunlara tepkiler ekleyebilirsiniz:

Artık Microsoft çalışanları GitHub Sorunlarının tüm gücünden yararlanarak bildirilen sorunları önceliklendirme, yanıtlama, planlama ve düzeltme işlemlerini tamamlayabilir ve süreci her zaman görebilirsiniz!

Örnek belge geri bildirimi

Bir makalede bozuk köprü için GitHub sorunu oluşturduğunuzu varsayalım. Ekibimiz sorunu önceliklendirmek, bir etiket atamak ve düzeltmeyi yapmak için bir sahip atayacaktır (veya takip soruları soracaktır). Sahip sorunu çözen bir çekme isteği gönderdiğinde, sorunun çözüldüğü/kapatıldığı ve verimli bir geri bildirim döngüsü oluşturduğunuz size bildirilir (GitHub bildirim ayarlarınıza göre).

Buna ek olarak, yorumlarda Markdown, bireysel sorunlar veya depoların tamamı için abonelikler, kuruluş etkinliğinin RSS akışları, @ bahsetmeler, atananlar ve daha fazlası gibi tüm standart GitHub iyiliğinden yararlanabilirsiniz! Daha derin bir açık kaynak araç tümleştirmesi düzeyinin, topluluk büyümesi ve işbirliği için yeni fırsatlar sunacağına inanıyoruz.

Ürün Geri Bildirimi Ayrımı

Önceki sistemle ilgili sorunlardan biri, bir akıştaki ürün ve belge geri bildirimlerinin karışımıydı. Tüm öğeler tutarlı bir şekilde etiketlenmediğinde önceliklendirmek ve izlemek son derece zordu. bu ikisini ayırmak için net bir yol oluşturarak bu sorunu çözmek için bir adım ileri sürdük:

Ürün geri bildirimi ver'etıklayarak, artık doğrudan belirli belgeler sayfasıyla ilişkili ürün ekibinin ürün geri bildirimini işlediği siteye yönlendirilirsiniz.

Roll-Out

Geri bildirim sisteminin ne zaman canlı olacağını merak ediyor olabilirsiniz. Visual Studio IDE ve Azure CLI belgeleriiçin birkaç aydır bunun pilotunu yapıyoruz. Şubat ayının ortasından itibaren bunu tüm docs.microsoft.com dağıtmaya başlayacağız.

Geri Bildiriminiz

Geri bildirimleriniz bizim için önemlidir, bu nedenle bu yeni sistemi hızlıca elinize almak istiyoruz. Bu, platformumuzda geri bildirim ve katılımı geliştirmenin bir sonraki adımı olsa da, son adımımız hiçbir şekilde değildir. GitHub'da değişiklikler hakkındaki düşüncelerinizi dile getirmeyi unutmayın veya Twitter 'dabizi etiketleyin.