NDoc ölüm döşeğinde – Microsoft’un “Sandcastle”ını bekliyor.

[Womanne]

NDoc açık kaynak projesi durdurulacak. Bu arada Microsoft, .NET yazılım bileşenlerine yönelik dokümantasyon aracının (kod adı Sandcastle) ilk alfa sürümünü sundu.

Duyuru



C# (sürüm 1.0’dan itibaren) ve Visual Basic (sürüm 8.0’dan itibaren) programlama dilleri, program kodunu XML formatındaki belirli yorumlarla zenginleştirmenize olanak tanır. Dil derleyicileri, XML yorumlarından, .NET yazılım bileşenlerinde (derlemeler) depolanan meta verilerle birlikte, derleme için otomatik olarak belge oluşturmak için kullanılabilen XML dosyaları oluşturur.

C#’taki XML yorumlarına örnek:

///
/// Bu yöntem tüm kalkış havalimanlarının listesini bir dizi dize olarak döndürür
///
/// Başlangıç konumlarına sahip dize dizisi
genel statik dize[] Tüm Kalkış havalimanları()
{
const string SQL = “FL_Abflugort’un FL_Fluege grubundan FL_Abflugort’u seçin”;
SQLUtil.GetColumn(SQL) değerini döndürün;
}

Visual Basic’teki XML yorumlarına örnek:

”’
”’ Bu yöntem, tüm kalkış havalimanlarının listesini bir dizi dize olarak döndürür
”’
”’ Başlangıç konumlarına sahip dize dizisi
Genel paylaşılan işlev AllDeparturePorts() As String()
Const SQL As String = “FL_Abflugort’un FL_Fluege grubundan FL_Abflugort’u seçin”
SQLUtil.GetColumn(SQL) değerini döndürür
İşlev sonu

NDoc

Visual Studio 2003, derleme meta verilerine ve XML yorumlarına dayalı (özellikle çekici olmayan) HTML belgeleri oluşturan bir özellik içeriyordu. Visual Studio 2005’te böyle bir işlevsellik yoktur. Microsoft muhtemelen yerleşik aracın, HTML dosyalarının yanı sıra diğer birçok çıktı biçimini destekleyen açık kaynaklı bir belgeleme aracı olan NDoc’tan çok daha kötü olduğunu fark etmiştir; bunlara benzer derlenmiş HTML dosyaları (.chm) de dahildir. Microsoft’un MSDN belgeleri.

NDoc belgelerine örnek



NDoc ile oluşturulan belge örneği (açık kaynak .NET 2.0 World Wide Wing örnek olay çalışmasından):

Ne yazık ki NDoc projesinin durma noktasına geldiği görüldü. .NET 2.0 uyumlu bir NDoc sürümü, resmi NDoc proje sitesinde mevcut değildi, yalnızca bir blog aracılığıyla mevcuttu.

NDoc üzerinde çalışan tek geliştirici olduğunu iddia eden NDoc proje yöneticisi Kevin Downs, bunu 26 Temmuz’da duyurdu. personel ve mali destek eksikliği nedeniyle artık projede çalışmayacağını resmen duyurdu.

“NDoc 2.0 üzerinde çalışmayı bırakmaya ve artık herhangi bir açık kaynak geliştirme çalışmasına katılmamaya karar verdim… Ne yazık ki, NDoc’un neredeyse her yerde kullanılmasına rağmen, .Net geliştiricilerinin projesine ne finansal olarak ne de aracılığıyla herhangi bir topluluk desteği sağlanamadı. kalkınma katkıları.”

Bu bağlamda Microsoft’un .NET için açık kaynak projelerini desteklememesi eleştiriliyor.

Microsoft’un Kumdan Kalesi

Microsoft’un 29 Haziran 2006’da “Sandcastle” kod adı altında XML yorumları için kendi dokümantasyon aracını duyurması gerçeği, Kevin Downs’a göre NDoc’tan vazgeçme kararının nedenlerinden yalnızca biri, ancak belirleyici olanı değil.

Redmond Sandcastle şu anda yalnızca komut satırında çalışan çok erken bir ön sürüm sürümünde mevcut. Yeni Microsoft aracı henüz NDoc gibi bir grafik kullanıcı arayüzü sunmuyor. Sandcastle, .NET Framework 2.0 ve Microsoft HTML Help Workshop’u temel alır.


()



Haberin Sonu