Kasım docs.microsoft.com güncelleştirmesi
Bu gönderi Bulut + Kurumsal Bölümü Genel Müdürü Jeff Sandquist tarafından yazılmıştır.
Bugün, Linux üzerinde Azure, Visual Studio 2017 RC, C++, ASP.NET Core, Entity Framework Core ve SQL belgelerini docs.microsoft.com'a geçirdiğimizden gurur duyuyoruz!
Tüm içeriğimizi bir araya toplamak; müşterilerimiz için deneyim tutarlılığı ile mobil destek, yerelleştirme, yorumlar, sosyal paylaşım veya topluluk katkılarını artıracak.
Bu büyük bir sürüm olsa da, içerik ve site özelliklerini güncelleştirmeye devam edeceğiz. Bu nedenle, lütfen içerik deneyimi ile ilgili UserVoice geri bildirimlerinizi bize iletin.
Ayrıca önümüzdeki aylarda Dynamics 365, Windows Server, SQL Server, System Center ve Windows masaüstü içerikleri de eklenecek.
Bu Gönderide
- Docs Temel Özellikler
- Yeni Docs Özellikleri
- Azure Belgeleri
- Visual Studio 2017 RC Belgeleri
- C++ Belgeleri
- ASP.NET Core Belgeleri
- Entity Framework Core Belgeleri
- Linux üzerinde SQL Belgeleri
Docs Temel Özellikler
docs.microsoft.com hakkında bilgi sahibi olmayanlar için, yeni deneyimimizin bazı temel özellikleri aşağıdadır.
Tahmini Okuma Süresi ve Son Güncelleştirme
Girişinize göre yaptığımız basit bir geliştirme, bir makale için tahmini bir okuma süresi sağlamaktır. Toplantılar arasındaki bu birkaç dakika boyunca çoğunuzda teknolojileri öğrendiğinizi ve değerlendirdiğiniz ve zaman taahhüdünün ne kadar gerekli olduğunu biliyorsanız makaleleri okuma olasılığınız daha yüksek olduğunu biliyoruz.
Ayrıca, müşterilerin içeriğin ne kadar yeni olduğunu anlamasına yardımcı olacak zaman damgaları ekledik. Artık bir makalenin en son ne zaman güncelleştirildiğini tahmin etmek zorunda değilsiniz.
Esnek Tasarım
Mobil cihazlar, tabletler ve bilgisayarlarda harika bir deneyim için duyarlı bir düzen uyguladık. Küçük ekranlı cihazlarda ekranın üst tarafındaki Seçenekler düğmesine tıklayarak bir masaüstü tarayıcıda görebileceğiniz tüm seçeneklere erişebilirsiniz.
Global Belgeler
Uluslararası müşterilerimizden yerelleştirilmiş içeriğin ne kadar önemli olduğunu çok kez duyduk. docs.microsoft.com artık Dynamics 365 için yerelleştirilmiş belgelerin bulunmadığı durumlarda geri dönme mantığıyla birlikte Arapça ve İbranice gibi sağdan sola doğru yazılan diller dahil 45 dil ile 63 yerel dil ayarını destekliyor. Bu, belgelerimizi gerçekten globalleştiriyor ve yeni yılda gelecek ek içeriğe hazır hale getiriyor.
Kenar Notları ve Yorumlar
Sorularınız, yorumlarınız ve geri bildirimleriniz bizim için önemlidir. Tüm makalelerimizle ilgili yorumlar ve yan notlar sağlamak için Livefyre ile iş ortaklığı yaptık. Her makalenin en üstünde doğrudan açıklamalar bölümüne atlama seçeneğini görürsünüz.
Görüşlerinizi almak istiyoruz ve Docs sayfalarına bırakılan tüm yorum ve soruları izlemeyi ve yanıtlamayı hedefliyoruz.
Yorum yazmak için, mevcut Twitter, Facebook, Google, Yahoo veya Microsoft kimlik bilgilerinizi kullanarak oturum açabilirsiniz.
Ayrıca, yanıt beklediğiniz konuları izleyebilirsiniz. Ekibimiz veya topluluğun bir üyesi size yanıt verdiğinde haberdar olun.
Ayrıca, içeriğin her bir paragrafına veya vurgulanan belirli bir metne kenar notları ekleyebilirsiniz. Bunu yapmak için, fare imleciyle bir metin parçası seçin veya paragrafın üzerine geldiğinizde sağ tarafta görünen yorum simgesine tıklayın.
Sosyal Paylaşım
Sayfanın üstündeki paylaşım düğmesi, içeriğimizi Twitter takipçileriniz ve Facebook arkadaşlarınız ile kolayca paylaşmanızı sağlar.
Ayrıca bağlamsal pencere öğesi aracılığıyla paylaşmak üzere içeriği fare ile doğrudan seçebilirsiniz.
Açık / Koyu Renkli Tema
Ayrıca, açık [asked for on UserVoice](https://msdocs.uservoice.com/forums/364242-general-site-feedback/suggestions/14999211-komplete-dark-theme)ve koyu tema arasında geçiş yapabileceğiniz bir tema seçici de ekledik.
Kullanıcı dostu 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. İşte yeni URL'lerimizle aynı makalenin bir örneği.
Önce
https://technet.microsoft.com/library/dn646983.aspx3
Sonra
https://docs.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune
Topluluk Katkıları
Sitemizdeki belgelerin çoğu topluluk katkılarına açıktır. İlgili GitHub sayfasına gitmek için sağ üst menüde Düzenle düğmesine tıklayın, depoda çatal oluşturun, bir değişiklik yapın ve çekme isteğinizi gönderin. Yerelleştirilmiş içeriklerdeki düzenlemelerinizi ve genel katkı deneyimi hakkındaki görüşlerinizi de bekliyoruz!
Yeni Docs özellikleri
Bu özelliklerin çoğu Mayıs’ta tanıtılmıştı ancak aşağıda açıklanan yeni özellikleri de ekledik.
Gerçek Zamanlı İçindekiler Filtresi
İçindekiler bölümünü anında filtre uygulanabilir hale getirdik. Yani artık aradığınız içeriği bulmak üzere birkaç karakter yazarak kolayca eşleşen metinlere filtre uygulayabilirsiniz.
Sol Gezinti Bölmesinde İçindekiler
Eklediğimiz diğer bir temel özellik, birden fazla sitede bulunan içerik sorununu gideriyor. Azure App Service’e bir ASP.NET uygulaması dağıtma hakkındaki bir makale Azure altında mı yoksa ASP.NET altında mı olmalıdır? İkisinde de olmalıdır, ancak bulunabilirlik ve tutarlılık nedenleriyle içeriğin iki site bölümüne de kopyalanmaması gerekiyor.
Bunu yapmak için, belgelerdeki herhangi bir içeriği seçerek bu içeriğin müşteriler için bir görünümünü oluşturan içerik ekiplerinden yararlanıyoruz. Aşağıdaki resimde, tek bir görünüm içinde Azure, ASP.NET ve .NET Core içeriklerini barındıran, Docker kullanan .NET geliştiricilerine ve Visual Studio Azure SDK ekiplerine yönelik örnek bir düzen gösterilmektedir.
Doğrulanabilen Kod Örnekleri
Belgelemenin en can sıkıcı özelliklerinden biri, sunulan veya bağlantılı örneklerin makinenizde çalışmamasıdır. Microsoft olarak, binerce kod örneği ve kod parçacığı sunuyoruz ve müşterilerimizin bu örneklerin desteklenen platform ve yapılandırmalarda çalışacağına güven duyduğundan emin olmak istiyoruz.
Bunu yapmak için, örneklerin belirli bir işletim sistemi ve araç zinciri kümesinde derlenebilir ve beklenen sonucu üretebilir olmasını sağlamak üzere genişletilebilir bir Sürekli Tümleştirme (CI) sistemi geliştirdik. Daha fazla ekibi bu sisteme eklemek için çalışıyoruz ve kodumuzu indiren kullanıcıların tüm gerekli kalite denetimlerinden geçtiğinden emin olmalarını istiyoruz.
Tümleşik Başvuru İçeriği
Temel alınan DocFX altyapısını, yani docs.microsoft.com’u destekleyen açık kaynak bileşeni yeniden tasarlayarak farklı platform ve biçimler için dil bağlamaları ekledik. Buna aşağıdakiler için destek dahildir:
- Azure CLI (Python)
- PowerShell
- .NET ve .NET Core
- Java
- Swagger / REST API’leri
Müşteriler için bu, artık belgeler ve kod için tek bir kaynak olması ve dolayısıyla, belgelerde API özellikleriyle eşitleme uyumsuzluğundan kaynaklanan kaymalar olmayacağı anlamına gelir. Aşağıdaki Azure ve ASP.NET/EF bölümlerinde API başvuruları için belirli destek hakkında daha fazla bilgi edinebilirsiniz.
PDF Desteği
Müşterilerin istediği diğer bir büyük özellik PDF desteğiydi. Artık belirli bir belge kümesini gigabaytlarca yer kaplamadan indirebilir ve masaüstü veya mobil cihazınızda istediğiniz yere götürebilirsiniz.
Bunu yapmak için içindekiler bölümümüzde PDF desteğini etkinleştirdik. Canlı sitede güncelleştirmeler yapıldıkça PDF’in de güncelleştirilmesini sağladık, böylece her zaman en yeni ve en iyi içeriklerimize ulaşabilirsiniz.
<img alt="screenshot16]()
Azure Belgeleri
Bu deneyimle ilgili parçalanma ve zorluklarla ilgili geri bildirimlerinizi aldık, bu nedenle Azure teknik belgelerimizi azure.microsoft.com, MSDN ve GitHub'dan geçirme ve üzerinde https://docs.microsoft.com/azure/birleştirme yolculuğumuzda iyiyiz.
Yeni Azure Hub Sayfası
Azure için giriş sayfasının görünüm ve işlevini de değiştirdik. Bazı önemli değişiklikler aşağıdakileri içerir:
- Azure hizmetlerini kategoriye göre gruplanmış olarak listeleyen bir Hizmetler sekmesi.
- REST API, Azure .NET SDK, Azure Java SDK, Azure CLI ve Azure PowerShell için tüm Azure Başvurusu içeriğini listeleyen bir Geliştirici sekmesi.
- Mimar ve geliştiricilerin bulut ölçekli tasarım desenleri hakkında bilgi alması için bir Mimari sekmesi.
Yeni Hizmet Sayfası
Giriş sayfalarımızın tutarlı olmasını ve aşağıdakiler dahil temel kaynaklara bağlantı içermesini sağladık:
- Hizmete Genel Bakış bağlantısı.
- Tüm ilgili platformlar ve programlama dilleri için Başlarken öğreticileri.
- Belirli bir hizmet için tüm video öğreticilere bağlantılar.
- API başvuru içeriğine bağlantılar.
- İlgili hizmete yönelik tüm belgeleri indirmek için bir bağlantı.
Yeni İçindekiler
docs.microsoft.com/azure’a geçiş yaparken İçindekiler’de gezinmeyi daha tutarlı hale getirme fırsatından yararlanıyoruz. Her bir hizmet benzersiz özelliklere sahip olsa da, artık site genelinde tutarlı bir gezinti deneyimiyle karşılaşacaksınız.
Gelişmiş Renklendirme
Azure Komut Satırı Arabirimi’ni (CLI) temsil eden kod örnekleri için, kodumuzu okumayı ve anlamayı kolaylaştırmak amacıyla anahtar kelimeler ve parametreler için renklendirme ekledik.
Başvuru İyileştirmeleri
Aldığımız en önemli şikayetlerden biri API’miz, komut satırımız ve PowerShell içeriğimizin hiçbir zaman güncel olmamasıydı. Azure hızlı bir şekilde değiştiğinden eski el ile iş akışlarımız çalışmıyor.
Bu sürümde, sistemlerimizi doğrudan kaynak koddan başvuru oluşturacak şekilde değiştirdik. Yeni derlemeler sunulduğunda yeni içerik de sunulacaktır. Ayrıca Nasıl Yapılır içeriğimize katkıda bulunabildiğiniz gibi, belgenin otomatik olarak oluşturulan bölümüne de aynı şekilde katkıda bulunabileceksiniz.
Ayrıca, REST API’lerimizi tanımlamak için Açık API Belirtimi (önceden Swagger olarak biliniyordu) kullanımını standartlaştırdık. Böylece REST hizmetleri için belgeleme ve istemci SDK’ları için kullanılabilen tutarlı bir veri gösterimi sağlanabilecek. Gelecekte REST belgelerimiz ve örnek istek/yanıt yükleri için etkileşimli özellikler de eklenebilecek.
Bu sürümde aşağıdakiler etkinleştirildi:
Visual Studio 2017 RC Belgeleri
Tüm Visual Studio belgelerini doğrudan yeni ve güncelleştirilmiş docs.microsoft.com deneyimiyle tümleşik olarak sunuyoruz.
Yeni Visual Studio Hub Sayfası
Visual Studio Hub sayfası Visual Studio 2017 Sürüm Adayı’nı kullanmaya başlamak için temel bağlantıları içerir.
Bu Yükleme Kılavuzu, Yenilikler ve Başlarken öğreticilerini içerir. Yerelleştirilmiş içerik yakında kullanıma sunulacaktır. Yeniden düzenleme, bir projede olmayan kodla çalışma, hata ayıklama performans sorunları, Visual Studio başlangıç zamanını en iyi duruma getirme, düzenleyicideki tüm yeni üretkenlik ve kod gezinti özelliklerinin ayrıntıları ve diğer konular için yeni içerikler sunulacaktır.
Visual Studio yalnızca kullanmak istediğiniz bileşenleri edinebildiğiniz tamamen özelleştirilebilir bir yükleme sürecini desteklediğinden, bunun iş yüklerinizin ASP.NET, Azure, Python veya Windows platformlarını içermesinden bağımsız olarak bireysel dağıtım projeleriniz için nasıl çalışacağı hakkında bilgi edinebilirsiniz.
ASP.NET ve Entity Framework Core Belgeleri
ASP.NET Core ve Entity Framework Core belgeleri de sırasıyla docs.asp.net ve GitHub’a geçirildi.
ASP.NET / Entity Framework Başvurusu
ASP.NET Core ve Entity Framework Core açık kaynak projeler olduğundan, ilgili API başvuru belgelerini oluşturmak için kaynak kodu ve üç eğik çizgi açıklamaları derinlemesine tümleştirildi. Bu, API ve belgelerin her zaman otomatik olarak eşitlenmiş olarak kalacağı anlamına geliyor.
C++ Belgeleri
Müşterilerden uzun zamandır aldığımız isteklere yanıt olarak, C++ başvurusunu konular arasında daha az bağlantı gerektiren daha kompakt bir biçimde yeniden düzenledik. Artık sınıf üyeleri için tüm belgeleri sınıfla aynı konuda bulabilirsiniz.
Ayrıca, en son C++ standartlarıyla uyumluluk değişiklikleri ve /fastlink gibi yeni derleme seçenekleri hakkında bilgi edinebilir, kodunuzu önceki Visual Studio sürümlerinden yükseltmek için yeni taşıma kılavuzunu kullanabilir ve gcc ile Linux sistemlerde derlemeye yönelik yeni desteği nasıl deneyeceğinizi keşfedebilirsiniz!
Linux üzerinde SQL Belgeleri
Linux üzerinde SQL Server (SQL Server vNext Customer Technical Preview 1’in parçasıdır) kullanıma sunuldu ve denemeniz için hazır! Hub sayfası sizi Linux üzerinde SQL Server kullanmaya başlamadan yönetme ve geliştirmeye kadar götüren temel bağlantılar içerir. Yerelleştirilmiş içerik yakında kullanıma sunulacaktır.
Sonuçlar
Yeni belge sitesine daha fazla özellik eklemek için sabırsızlanıyoruz ve deneyiminizin ürün ve hizmetlerimizle tutarlı olduğundan emin olmak için çalışıyoruz. Kullanıcı olarak siz belge sürecinin en kritik parçası olduğunuzdan, bize ulaşmanızı ve bu deneyimi Twitter'da sizin için nasıl daha iyi hale getirebileceğimiz hakkında geri bildirimde bulunmanızı öneririz.