.NET Core Belgeleriyle tanışın
Bu gönderi Bulut + Kurumsal Bölümü Genel Müdürü Jeff Sandquist tarafından yazılmıştır.
Bugün docs.microsoft.com üzerinde .NET Belgelerinin bir önizlemesini yayımladık. Yeni belge deneyimi geliştirmeleri docs.microsoft.com teklifler hakkında daha fazla bilgi edinmek için tanıtım docs.microsoft.com blog gönderisini ziyaret edin. docs.microsoft.com platformunda tüm işbirliğine dayalı özelliklere, açık kaynaklı içeriğe ve daha kolay URL'lere sahip olmanın yanı sıra.NET geliştiricilerine özgü bazı yeni özellikler de kullanıma sunuldu. Bu gönderi, bu yeni özellikleri vurgulayacak ve geleceğe yönelik planlarımızı özetleyecektir.
.NET Belge Deneyiminin Öne Çıkanları
.NET Core'un heyecan verici RTM sürümüne eşlik etmek için bunu .NET Belgeleri giriş sayfasında öne ve ortaya koyuyoruz. .NET Core RTM sürümünü hızla kullanmaya başlamak için ihtiyacınız olan her şeyle tamamlamak için, listenin en üstüne makalelere bağlantılar ve yeni bir başvuru deneyimi koyduk.
.NET Ekosistemi Parmaklarınızın Ucunda
.NET kullanarak iOS uygulamaları oluşturmak ve .NET kullanarak Evrensel Windows Platformu (UWP) uygulamaları oluşturmak için Xamarin kullanarak yeni .NET Core kitaplıklarını, ASP.NET, Entity Framework'ü, Azure'ı indirme bağlantılarını göreceksiniz. Henüz .NET içeriğinin tamamını docs.microsoft.com'a taşımadık, ancak .NET Belgeleri giriş sayfası tüm .NET belgelerine ulaşmak için başlangıç noktanız olacaktır.
Makaleler
Yazarlarımız ve mühendislerimiz ve birkaç adanmış topluluk üyesi, .NET Belgeleri bölümünde bulacağınız .NET Core ile ilgili yeni makaleler oluşturmak için yorulmadan çalışıyor. Burada aşağıdakiler gibi çeşitli makaleler bulabilirsiniz:
Bunların ve diğer birçok konunun tümü docs.microsoft.com temasında, her sayfada temiz bir içindekiler tablosu ve her makalenin tahmini okuma süresi ve her makale için katkıda bulunan bilgileri sunulur.
Tüm .NET makaleleri açık kaynaktır ve GitHub'da.NET ekibinin docs deposunda bulunabilir. Belgelerde herhangi bir sorun bulursanız veya bunu geliştirmek isterseniz, bunu yapmak her makalenin sağ gezinti bölmesindeki düzenle düğmesine tıklamak kadar kolaydır.
Bir makaleyi düzenlemek, depodaki Markdown dosyalarından herhangi birinde düzenle düğmesine tıklamak, içeriğinizi eklemek ve çekme isteği göndermek kadar kolaydır. Ekibimiz çekme isteğinizi inceleyip kabul ettikten sonra katkılarınız dakikalar içinde sitede yayınlanacaktır.
API Başvurusu
Yazarlarımız, mühendislerimiz ve tutkulu topluluk üyelerimiz tarafından yazılan harika içeriklere ek olarak, başvuru deneyiminde önemli geliştirmeler yaptık. Başvuru deneyimi, docs.microsoft.com makalelerinde kullandığımız tasarım ilkelerine dayanarak bu önizleme sürümünde tamamen yeniden tasarlandı.
Bu makaleler gibi yeni başvuru sayfaları da hızlı yanıt verir, modern web ilkeleriyle tasarlanmıştır ve mobil cihazlarda daha iyi görünecektir.
Tüm Ad Alanı sayfalarınaTür Araması ekledik. Bu, tüm .NET türleri için tür adına göre kolayca aramanızı sağlar. Her tuş basmasıyla, sol gezintide gösterilen türlerin listesini filtreleyeceğiz. Başvuru alanının bu heyecan verici yeni özelliği, GitHub'da açık kaynak bir proje olan DocFX olarak bilinen .NET başvuru belgelerini oluşturmaya yönelik yeni çerçevemize eklenmiştir.
Herhangi bir ad alanı için sol gezinti bölmesindeki tek tek türlere tıkladığınızda, doğrudan ad alanı sayfasının bu türe giriş bölümüne atlarsınız. Başvuru içeriğinin ana alanındaki türün adına tıklayarak sınıfın devralma zincirini, bildirimini ve sınıfın özelliği ve yöntem üyeleri hakkındaki ayrıntıları içeren ayrıntı sayfasını görürsünüz.
Her yöntem üyesi için parametrelerle ilgili ayrıntıları ve yöntemin özetini görürsünüz.
Bilgi ve Mühendislik İlkeleri
DocFX belge oluşturma araçlarında sürekli geliştirme ve geliştirmenin yanı sıra, yeni .NET Belge deneyiminde göreceğiniz mühendislik ve belge ilkelerine yönelik önemli geliştirmeler yaptık.
Daha İyi Otomasyon
Olası katkıda bulunanlardan çekme istekleri alındığında, katkıda bulunanın Katkıda Bulunan Lisans Sözleşmemizi imzalamak için basit bir süreci izlediğini doğrularız (bu işlem tamamen elektroniktir ve tamamlanması birkaç dakika sürer). Katkılar , Katkı Yönergeleri'ne uygun olduğu sürece, çekme istekleri kabul edildikten dakikalar sonra sitede küçük değişikliklerin canlı olarak görünmesi gerekir.
Daha iyi URL'ler
Genel docs.microsoft.com deneyiminin önemli ilkelerinden biri, arama dizini oluşturmayı ve "tahmin etme" iyileştirmeye yönelik daha iyi URL'lerdir. Bu ilkeyi .NET Belgelerinde koruduk. Hem makalelerde hem de başvuru belgelerinde daha temiz URL'ler vardır. Örneğin, Sistem ad alanı için klasik MSDN URL'sini inceleyin:
Yeni başvuru belgelerinde URL daha mantıksal, insan tarafından okunabilir ve en önemlisi daha bulunabilir.
Daha Çevik ve Açık Yazma
İçerik yalnızca açık kaynak değildir ve yalnızca topluluk katkılarını kabul etmekle kalmaz. Buna ek olarak, docs.microsoft.com'daki tüm içerik (.NET Belgeleri dahil) creative commons lisansı altında sağlanır. Bunu okuyabilir, kopyalayabilir, başvurabilir ve bölümlerini yeniden kullanabilirsiniz (ticari kullanım için bile). Yazarlar ve mühendisler, yeni sistemde aylardır topluluk üyeleriyle aktif olarak çalışmaktadır. bu ilginç ve heyecan verici bir geçiş oldu ve gelecekte daha fazla gelecek var.
Gelecek Planları
sitenin geri kalanı gibi docs.microsoft.com'nin bu bölümü de önizleme aşamasında olduğundan yapıcı geri bildirimleri ve yorumları teşvik ediyoruz. Lütfen özellik fikirlerinizi UserVoice'a gönderin.
Önümüzdeki haftalarda başvuru belgeleri oluşturmak için kullanılan XML açıklamalarını doğrudan .NET kaynak kodunda yayımlayacağız. Bu, herkesin .NET Framework başvuru belgelerini kolayca güncelleştirmesine olanak tanır.
Ayrıca başvurunun tasarımını ve düzenini, ayrıca başvuru içeriğini düzenleme özelliğini ayarlamaya devam edeceğiz.
size docs.microsoft.com'de yeni .NET Belgeleri alanını sunmak için heyecanlıyız ve gelecekte deneyiminizi daha iyi hale getirmek için sabırsızlanıyoruz!