MSDN ve TechNet’in docs.microsoft.com’a Geçişi Hakkında Güncelleştirme

  • Makale

Bu gönderi Geliştirici İlişkileri Kurumsal Başkan Yardımcısı Jeff Sandquist tarafından yazılmıştır.

Bugün, MSDN ve TechNet içeriklerinin docs.microsoft.com’a geçirilmesine ilişkin önemli bir güncelleştirmeyi heyecanla sizlere sunuyoruz. Bu blog gönderisinde içerik yapısının, biçimin ve temel alınan altyapının tamamen değiştirilmesini kapsayan ve şirket genelinde yürütülen bir çalışmanın son adımlarını içerir.

MSDN ve TechNet’ten docs.microsoft.com’a

Microsoft Developer Network, 1992 yılında Windows için programlamaya ilişkin teknik bilgi sağlamayı amaçlayan bir müşteri aboneliği hizmeti olarak kullanıma sunuldu. Altı yıl sonra 1998’de, 250.000 sayfalık içerik barındıran MSDN Online sitesi hayata geçirildi.

1999’da MSDN Online ekran görüntüsü

O günlerde yayımlama süreci, içeriği Microsoft Word’de oluşturup HTML’ye dönüştürme ve pubwiz (Yayımlama Sihirbazı) adlı araç aracılığıyla yayımlama adımlarından oluşuyordu. 20 yıl boyunca, bu sürecin sağladığı destek ile yeni ürünler, hizmetler ve güncelleştirmeler sunuldu. Sonuç olarak ise 45 milyon sayfalık teknik içerik ortaya çıktı!

Yıllar süren ürün yayımlama döngüsü aylar içinde gerçekleşebilir hale geldiğinde erişilebilir ve güncel belgelere olan talep arttı. Yayımlama sisteminin mühendislik hızıyla eşleşmesi gerekiyordu. Bu nedenle, Microsoft olarak bulut çağında belgelerin yönetim şeklini yeniden tasarlamaya karar verdik. Kasım 2015’te, docs.microsoft.com ekibinin kurucu üyeleri Dan Fernandez, Mary McHale, Carol Zeumault ve Jeff Sandquist, Star Wars’un Bölüm IV ile aynı adı taşıyan ve yeni sitenin vizyonuna vurgu yapan “A New Hope” (Yeni Bir Umut) adlı bir belge yazdı. Belge, bazı önemli yol gösterici ilkeleri içeriyordu:

  • Birleşik teknik belgeler. Yeni sitenin, Microsoft’un barındırdığı onlarca belge web sitesini birleştirmesi gerekir. Veri temelli bir web uygulaması oluşturmayı öğrenen geliştiricinin ASP.NET, Azure, Entity Framework veya diğer Microsoft teknolojilerindeki alakalı içeriklerin tümünü bulmak için yalnızca bir siteyi ziyaret etmesi yeterli olmalıdır.
  • Gelişmiş kullanıcı deneyimi. Web sitesinin başarısını belirleyen önemli faktörlerden biri, müşterilerine sunduğu deneyimdir. Yeni sitenin daha iyi bir yükleme performansına, okunabilir yazı tiplerine, erişilebilir içerik tablolarına, insanlar tarafından okunabilen URL’lere, sürüm oluşturma desteğine, mobil tarayıcılarla uyumluluğa sahip olmanın yanı sıra erişilebilir özellikler ve uluslararası hale getirme desteği aracılığıyla kapsayıcı tasarım uygulamalarını izlemesi gerekir.
  • Herkesin yazmasına olanak tanıma ve topluluk etkileşimi. Yeni sitenin açık kaynak standartları ve araçları ile sunulması ve herkesin belge oluşturup düzenlemesine olanak tanıması gerekir. Sitenin içerik için Markdown’ı, otomatik olarak oluşturulan API belgeleri için YAML’yi ve temel alınan içerik katmanı için otomatik kalite denetimleri uygulanmasına olanak tanıyan GitHub’ı kullanması gerekir. MicrosoftDocs GitHub kuruluşunun 7.400’den fazla üyesi bulunur ve The State of the Octoverse 2018’de görüldüğü gibi GitHub’da en fazla katkının yapıldığı 5. depo olan Azure belge deposu, en hızlı büyüyen (yıldan yıla %470’lik büyüme) açık kaynak projelerden biridir!
  • API belgelerine yönelik destek. Yeni site, müşterilerimizin kullandığı .NET, Java, Python, JavaScript ve TypeScript, PowerShell, Azure CLI, Q#, OpenAPI ve daha fazlası dahil olmak üzere programlama dilleri ve platformları için yazılmış API'lerin belgeleri için birinci sınıf desteğe sahip olmalıdır. Deneyimin otomasyon ile sağlanması, güvenilir API kapsamının olması ve API belgelerinin yayımlanma sürecinin haftalardan ziyade dakikalar içinde gerçekleşmesi gerekir.
  • Mühendislik altyapısını modernleştirme. docs.microsoft.com’un Azure’da çalışarak bakım maliyetlerini azaltmamıza (yaklaşık 7 milyon ABD doları tasarruf), üç haftada bir olan dağıtım sürelerini bir güne (veya daha kısa bir süreye) düşürmemize olanak tanıması ve mühendislik çoğaltmasının azaltılmasına olanak tanıması gerekir.
  • Varsayılan olarak genişletilebilir. Sitenin geliştikçe müşterilerimizin ihtiyaçlarını en verimli şekilde karşılayabilmesi gerekir. Bu adımı atarak, yeni bir etkileşimli öğrenme deneyimi olan Microsoft Learn’ü ve örnek kod tarayıcımızı oluşturma ve tümleştirme olanağı elde ettik.

Modern platform sayesinde, değerli içerikleri yeni siteye geçirerek bunları kaybetmediğimizden emin olarak yola çıktık. Aşağıda, ilerleme durumumuz hakkında daha fazla bilgi edinebilirsiniz.

MSDN ve TechNet Kitaplıkları

Durum: ✅ Tamamlandı

MSDN Kitaplığı ve TechNet Kitaplığı’nın docs.microsoft.com’a geçirilmesine 2017’nin sonunda başladık ve geçişi bu yıl tamamladık.

Bu kitaplıklar, önceden API belgeleri, örnek kod ve teknik makaleler gibi Microsoft ürünlerine yönelik belgeleri sunuyordu. Başta CD’ler aracılığıyla kullanıma sunulan bu içerikler, MSDN ve TechNet web sitelerinin kullanıma sunulmasıyla çevrimiçi platforma taşındı.

Geçiş için çeşitli XML tabanlı biçimlerin insanlar tarafından düzenlenen içerikler için Markdown’a, otomatik olarak oluşturulan API belgeleri için de YAML’ye dönüştürülmesi ve yüzden fazla çeşitli içerik kümesini kapsaması gerekiyordu. Milyonlarca web sayfası için sayfa yönlendirmesi sunulmasını sağlayarak sitemizin dışındaki blog ve forum gibi kaynaklara açılan bozuk bağlantıları önledik.

Çalışmaya dahil edilen içeriğin miktarını merak ediyorsanız, aşağıdaki istatistikleri inceleyebilirsiniz:

Herhangi bir MSDN veya TechNet içeriğini yer işaretlerine eklediyseniz, bağlantılar docs.microsoft.com adresindeki yeni konumlarına yönlendirilir.

MSDN Dergisi

Durum: ✅ Tamamlandı

MSDN Dergisinin son sayısı 1 Kasım 2019’da yayımlandı. MSDN Dergisinin Ağustos sayısında okuyucu ve yazarlara son bir ileti gönderdik.

MSDN’de yayımlanan MSDN Dergisi içeriği docs.microsoft.com/archive adresine taşındı.

Abonelikleri için ücret ödeyen MSDN Dergisi abonelerine, aboneliklerinde kalan süre temel alınarak ücret iadesi yapılacak. İade çekleri, Kasım sayısı yayımlandıktan sonra gönderilecek. Bu değişiklik MSDN Platformu Aboneliklerini etkilemez.

Microsoft Developer ve TechNet Flash Bültenleri

Durum: ✅ Tamamlandı

MSDN ve TechNet’te yayımlanan bültenler docs.microsoft.com/archive adresine taşındı.

Mevcut aboneler bu bültenleri almaya devam edecek. Bunu geliştirip biçimi ve yayımlama zamanlamasını değiştirebiliriz.

Bültenlerimize abone olmak istemiyorsanız, alacağınız bir sonraki e-posta iletisinde aboneliğinizi kaldırabilirsiniz.

MSDN ve TechNet blogları

Durum: ✅ Tamamlandı

MSDN Blogları ve TechNet Blogları sitelerini Temmuz 2019’da salt okunur hale getirdik. MSDN ve TechNet blogları docs.microsoft.com/archive'a geçirildi ve arşivlendi.

MSDN veya TechNet bloglarına yer işareti eklediyseniz, bunlara yönelik bağlantılar docs.microsoft.com/archive'da yeni konuma veya etkin bir şekilde tutulan ve güncelleştirilen bloglar varsa diğer blog sitelerine yönlendirilir.

Durum: ✅ Tamamlandı

Tüm MSDN Kod Galerisi sayfalarını örnek tarayıcısına yönlendirdik ve önemli örnekleri GitHub’daki MicrosoftArchive kuruluşunda arşivledik. Bu işlem hakkında daha fazla bilgi edinmek için son blog gönderimize bakın.

En güncel kod örneklerini docs.microsoft.com/samples adresinde bulabilirsiniz.

Durum: 🚧 Devam ediyor

TechNet Gallery 2020’nin başında kullanımdan kaldırılacak. Site, Aralık 2019’da salt okunur yapılacak ve yeni topluluk katkılarını kabul etmeyecek. Daha fazla duyuru ve bilgi daha sonra paylaşılacaktır.

En güncel kod örneklerini bulmak için docs.microsoft.com/samples’ı kullanın. Daha önceden TechNet Gallery’ye katkıda bulunduysanız, örneklerinizi GitHub’ınız gibi kişisel olarak yönetilen bir konuma geçirdiğinizden emin olun.

TechNet Wiki

Durum: 🚧 Devam ediyor

TechNet Wiki için daha somut bir geçiş planı ve zamanlaması üzerinde çalışıyoruz. Daha fazla ayrıntı için lütfen daha sonra tekrar bakın. Wiki içeriğine katılmaya ve bunlarla etkileşime geçmeye devam edebilirsiniz.

MSDN ve TechNet Forumları

Durum: 🚧 Devam ediyor

MSDN ve TechNet forumlarının yerini alan Microsoft Soru-Cevap’ın önizleme sürümünü duyurduk. Geçişin sorunsuz olmasını sağlamak ve kesintileri en aza indirmek için geçiş sürecini birkaç aşamaya böldük. Geçişin 2020’nin ortasında tamamlanmasını bekliyoruz. Daha fazla ayrıntı için lütfen daha sonra tekrar bakın.

Channel 9

Durum: 🚧 Devam ediyor

Channel 9, geliştirici odaklı video içerikleri için önemli bir yatırım olmaya devam ediyor. Channel 9’da bulunan video ve teknik içeriklerimizin daha iyi tümleştirilmesi için bir geçiş yolu üzerinde çalışıyoruz. Daha fazla ayrıntı için lütfen daha sonra tekrar bakın.

Fikrinizi almak istiyoruz

Platformumuza yatırım yapmaya devam etmekten heyecan duyuyor ve tüm Microsoft ekosistemine yönelik en ilgili ve en güvenilir teknik belgeleri aldığınızdan emin olmak istiyoruz. Düşüncelerinizi ve geliştirme önerilerinizi GitHub ve Twitter’dan bize iletin.