docs.microsoft.com’a giriş

Bu gönderi Bulut + Kurumsal Bölümü Genel Müdürü Jeff Sandquist tarafından yazılmıştır.

Yeni belge hizmetimizin (https://docs.microsoft.com) Enterprise Mobility ürünlerimize yönelik destek bilgilerini içeren önizleme sürümünü kullanımınıza sunuyoruz.

Neden docs.microsoft.com?

Kısaca ifade etmek gerekirse, içerik önemlidir. Yüzlerce geliştirici ve BT Uzmanı ile görüşmeler ve anketler yaptık ve yıllar içinde UserVoice üzerinden web sitesi için ilettiğiniz geri bildirimleri inceledik. Değişiklik yaparak içerik için modern bir web deneyimi oluşturmamız gerektiği açıktı. İlk işimiz, mevcut TechNet ve MSDN içerik altyapımızı değerlendirmek oldu. 10-15 yıllık hassas bir kod temeliyle oluşturulan bu siteler, bulutta çalışacak şekilde tasarlanmayan eski bir yayımlama ve dağıtım sistemi üzerine kurulmuştu.

Yalnızca deneyime değil, aynı zamanda oluşturduğumuz içeriğe ve bunları nasıl kullandığınıza da odaklandık. Müşterilerimiz yıllardır, metinle sınırlı kalmayıp özellik düzeyinde içerikler sunmamızı ve iş sorunlarına yönelik çözümleri uygulamalarına yardımcı olmamızı istiyordu. Sunduğumuz içeriğin ve oluşturduğumuz platformun, müşterilerin çözümleri öğrenip dağıtmasını kolaylaştırması gerektiğini biliyorduk.

Genel deneyimi hatasız şekilde geliştirmek için en baştan başlamamız gerektiğini fark ettik ve bu çabamız sonucunda, Microsoft belgelerine yeni bir soluk getiren https://docs.microsoft.com ortaya çıktı.

Not: Web sitesinin bu önizleme sürümü *yalnızca* Enterprise Mobility Belgelerine (Gelişmiş Tehdit Analizi, Azure Active Directory, Azure RemoteApp, Multi-Factor Authentication, Azure Rights Management, Intune ve Microsoft Identity Manager’ı kapsayan belgeler) yönelik içerikleri kapsamaktadır. Gelecekte, geri bildirimlerinizin yardımıyla platformumuz geliştikçe daha fazla belgeyi bu deneyime taşımayı planlıyoruz.

Temel Özellikler

Aşağıda gösterilen örnek bir belge sayfasıyla başlayarak sitedeki yeni özelliklerden bazılarını gösterelim.

Documentation Example

Okunabilirlik

İçeriğin okunabilirliğini artırmak için siteyi, sabit bir içerik genişliğine sahip olacak şekilde değiştirdik. İzleme çalışmaları, uzun metinlerin soldan sağa gözle izlenmesi zor olduğundan, sabit bir içerik genişliği ile kavrama ve okuma hızının iyileştirilebileceğini göstermiştir. Bunu uygulamalı olarak göstermek için aşağıda verilen örneklerde, docs.microsoft.com üzerinde yayımlanan bir Intune makalesi ve hemen altında da aynı makalenin TechNet’teki görünümü sunuluyor. Ayrıca, müşterilerden gelen istekler (UserVoice - Yazı Tipi Boyutunu Artırma) doğrultusunda hem sol gezinti bölmesi hem de metnin kendisi için yazı tipi boyutunu artırdık.

Docs and TechNet comparison

Tahmini Okuma Süresi

Katkılarınızdan yola çıkarak yaptığımız basit iyileştirmelerden biri de makaleler için tahmini okuma süresi özelliğinin sunulması oldu. Çoğunuzun teknolojiyle ilgili bilgi edinme/değerlendirme işlemleri için yalnızca toplantılar arasında kalan birkaç dakikayı ayırabildiğinin ve bu nedenle makaleleri okumanın ne kadar süreceğini bilmeyi tercih ettiğinin farkındayız. Ayrıca, müşterilere bilgilerin UserVoice geri bildirimlerine göre ne kadar yeni olduğunu anlama konusunda yardımcı olmak amacıyla içeriğe tarih damgaları ekledik.

Estimated reading time

İçerik ve Site Gezintisi

Müşteri anketleri ve UserVoice geri bildirimleri temel alınarak yatırım yapılan alanlarından bir diğeri, site gezintisi, bilgi mimarisi ve içeriğin müşteri amacına göre düzenlenmesiydi. İçeriklerimizi; ürün veya hizmetlerin değerlendirilmesi, kullanılmaya başlanması, planlanması, dağıtılması, yönetilmesi ya da ürün veya hizmetle ilgili sorunlarının giderilmesi çerçevesinde, mantıksal gruplar halinde yeniden düzenledik. Bu içeriği hem sol gezinti bölmesinde hem de ürün/hizmet sayfalarında ayrıntılarıyla görebilirsiniz.

Intune belgeleri giriş sayfasının ekran görüntüsü aşağıda verilmiştir:

Intune documentation screenshot

Aynı kategorizasyon, makalelerin sol gezinti bölmesinde de bulunuyor:

Left navigation

Makaleler Artık Daha Kısa

Sıkça aldığımız geri bildirimlerden biri de, bazı içeriklerin uzunluğu nedeniyle bunaltıcı olabildiği ve uzun makalelerde gezinmenin ve aradığınızı bulmanın daha zor olduğu yönündeydi. Bu sorunu çözmek için, çok sayıda uzun makaleyi küçük mantıksal adımlara böldük ve makalelerin alt kısmına aşağıda gösterildiği gibi, çok bölümlü öğreticideki adımlar arasında gezinmenizi sağlayan Geri ve İleri düğmelerini ekledik.

Back and Next buttons

Çok bölümlü öğretici özelliği müşterilerin çoğu tarafından beğenilmekle birlikte, çok adımlı öğreticileri çevrimdışı ve yazdırmaya uygun tek bir PDF’te birleştirmek isteyen müşterilerin görüşlerini de değerlendiriyoruz. Bu özellik henüz sunulmadı, ancak önizleme sürümüne yakında eklenecek.

Esnek Tasarım

UserVoice üzerinden talep ettiğiniz gibi, mobil cihazlarda, tabletlerde ve bilgisayarlarda harika bir deneyim oluşturmak için esnek bir düzene geçiş yaptık. Seçenekler düğmesine tıklandığında, aynı seçeneklerin masaüstü görünümünde gösterilmesi için düğme genişletilir/daraltılır.

Responsive Page Design

Topluluk Katkıları

docs.microsoft.com üzerindeki tüm belgeler açık kaynaklıdır ve topluluk katkılarına izin verecek şekilde tasarlandı. Bu özellik, Microsoft’ta ASP.NET, Azure, .NET Core ve Microsoft Graph gibi belgelerinin tümünü veya bazılarını açık kaynağa geçirmiş olan diğer ekiplerden yola çıkılarak eklendi.

Her makalede, sizi GitHub’da içeriği düzeltmek veya iyileştirmek üzere kolayca çekme isteği gönderebileceğiniz kaynak Markdown dosyasına götüren bir Düzenle düğmesi (aşağıda gösterilmiştir) bulunur.

Geri Bildirim Mekanizmaları

Sorularınız, yorumlarınız ve geri bildirimleriniz bizim için önemlidir. Tüm makalelerimizde yorum ve kenar notu özelliği sunmak için Livefyre ile işbirliği yaptık. Her makalenin üst kısmında, aşağıda gösterildiği gibi yorumlar için bir bağlantı göreceksiniz.

Comments link

Yorumlara tıkladığınızda, yorum eklemek, takip etmek veya beğenmek üzere oturum açmak için (Twitter, Facebook, Google, Yahoo veya Microsoft kimlik bilgilerini kullanarak) sayfanın alt kısmına yönlendirilirsiniz.

Comments at bottom

Ayrıca, içeriğin her bir paragrafına veya vurgulanan belirli bir metne kenar notları ekleyebilirsiniz. Bunu yapmak için fareyi sağ taraftaki yorum simgesinin üzerine getirerek tıklayın ve satır içi bir yorum ekleyin.

Sidenote example

Sosyal Paylaşım

Sayfanın üstündeki paylaşım düğmesi, Twitter ve Facebook ile kolayca paylaşım yapmanızı sağlar.

Sharing to Twitter and Facebook

Ayrıca, fare imlecinizi kullanarak bir makaledeki içeriği seçebilir, yorum ekleyebilir ya da aşağıda gösterildiği gibi içerik menüsünden Twitter veya Facebook’ta doğrudan paylaşabilirsiniz.

Select and comment or share content

Kolay URL’ler

Web deneyimi bizim için önemli. TechNet ve MSDN kullanıcıları tarafından düzenli olarak bildirilen hatalardan biri, makalelerde yer alan URL’lerin kolay ve okunaklı olmadığına yönelikti. Aynı makalenin eski hali ile yeni URL’lerimizi içeren son hali, aşağıda örnek olarak gösterilmiştir.

Web sitesi temaları

UserVoice’a gelen istekler doğrultusunda ayrıca, makalelere açık ve koyu renkli tema arasında geçiş yapabilmeniz sağlayan bir tema seçici ekledik.

Light and Dark Theme Selector

Aşağıdaki resimde, açık ve koyu tema arasındaki farkı görebilirsiniz.

Light and Dark themes

Temel Öğeler

Site performansı gibi temel öğeler, çoğu müşterimizin UserVoice üzerinden geri bildirimde bulunarak geliştirmemizi istediği önemli özelliklerdir. docs.microsoft.com üzerinde sayfa yükleme süresi, önceki yükleme süresi ortalamalarına göre %50-300 daha hızlı ve coğrafi açıdan, öncekine göre daha iyi yayılmış durumda. Ayrıca, siteyi oluştururken tamamen Azure üzerinde çalışan bir mimariyi temel aldık.

Geri bildirimlerinizi bekliyoruz!

docs.microsoft.com’un önizleme sürümünden keyif almanızı umuyoruz. Geri bildirimlerinizi https://aka.ms/sitefeedback adresinden bize iletebilirsiniz. Gelecek gönderilerde, başvuru içeriği deneyimini önemli ölçüde geliştirmeye ve içerik yerelleştirmeye ilişkin planlarımızı ele alacağız.