Microsoft Geliştiricileri için Stack Overflow Belgeleri

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

Bugün, Microsoft geliştiricileri için Stack Overflow Belgelerini desteklemek amacıyla Stack Overflow ile iş ortaklığı kurduğumuzu duyurmak istiyoruz. Bu duyurunun bir parçası olarak Stack Overflow Belgeleri içeriğinin gelecekte docs.microsoft.com API başvuru içeriğiyle tümleştirileceğini duyuruyoruz. Microsoft, Stack Overflow ile uzun zamandır sponsorlu etiketler biçiminde iş ortağıdır ve Stack Overflow Belgelerinin kullanıma sunulması, topluluğun .NET Framework, Xamarin'i ve diğer Microsoft ürün ve teknolojilerini kullanarak kod örnekleri oluşturmanın ve oylamanın kolay bir yoluna sahip olmasını sağlar.

Paylaşılan Hedefler

Hem docs.microsoft.com hem de Stack Overflow'un ortak hedefleri vardı. Topluluğun ürün ve hizmetleri kullanmaya yönelik harika belgelere katkıda bulunmasını kolaylaştırmak ve basit hale getirmek istiyoruz. her iki içerik kümesinin de açık lisansı vardır, içerik biçimi olarak markdown kullanın ve topluluk katkılarını kolayca etkinleştirin (herhangi bir docs.microsoft.com sayfasında Düzenle'ye tıklayın).

.NET Geliştiricileri için Stack Overflow Hızlı Turu

StackOverflow Belgeleri'ne ilk ulaştığınızda, kullanılabilir konuların etiket tabanlı kategorisini görürsünüz. İlk bakışta StackOverflow topluluğu tarafından daha önce oluşturulan tüm etiketleri göreceksiniz. Etikete göre filtreledikten sonra, konu isteklerinin sayısı, önerilen değişiklikler ve iyileştirme istekleri gibi birkaç önemli ölçümün hemen önünde gösterildiği bir liste görüntülenir.

Konu İste

Birkaç geliştirici, StackOverflow hedef kitlesinin yardımı olmadan zor sorunları çözdü. StackOverflow'ı kendi ürünleriyle ilgili sorular için izleyen topluluktan iş arkadaşlarımız, meslektaşlarımız ve efsanelerimizle birlikte etiketlere göre düzenlenmiş bir bilgi ağı kurduk. Belgeler, her etiketin "İstenen Konular" bölümü topluca bilgi oluşturmaya yönelik hedef kitle taahhüdünden kaynaklanmıştır. Her etiketin "İstenen Konular" bölümü, topluluğa yaygın sorunları tanımlayacak bir yer sağlar.

"Konu Oluştur"a tıklayarak konu için içerik oluşturabilir, kendi kod örneklerinizi ve belgelerinizi sağlayabilirsiniz. Bu deneyim, içeriğin her bölümünün nerede sağlandığı konusunda rehberlik sağlar ve isterseniz Markdown söz dizimi kullanılarak düzenlenebilir. Konuları oluştururken ilerleme durumunuz, henüz tamamlamadığınız veya gözden geçirilmeye gönderilmemiş tüm taslak içeriği görebileceğiniz doğru gezintiye kaydedilir.

Tanıdık Kod Görüntüleme Deneyimi

StackOverflow Q&A sitesinde olduğu gibi, tek tek konuların kodu net ve kısa bir biçimde sunulur, böylece kopyalama-düzenleme-kullanımı veya yalnızca kodu okumaktan ders çıkarabilirsiniz. Geliştiriciler, Stack Overflow'da verilen yanıtlar gibi kod örneklerini yukarı/aşağı oylayabilir.

Gelecekteki Tümleştirme

Gelecekte docs.microsoft.com, Stack Overflow belge örneklerinin seçilmiş listesini doğrudan Microsoft API belgeleriyle tümleştirecek. Microsoft API başvurusuna bakan geliştiriciler hem Microsoft tarafından oluşturulan örnekleri hem de topluluk tarafından oluşturulan Stack Overflow örneklerini görür. Kod örneklerinin belirlenmiş .NET kodlama yönergelerini ve en iyi yöntemleri kullandığından emin olmak için örnekler seçilmiştir. Gelecekte bu tümleştirme hakkında daha fazla ayrıntı yayınlayacağız.