Veritabanı paketlerimizi bir API olarak daha fazla belgelemeye çalışıyorum. İstediğimiz, PL/SQL için JavaDocs gibi bir şey. Dışarıda birkaç araç gördüm (pldoc, plsqldoc) ama onları nasıl kullanacaklarını bilen kişilerden bilmek isterim.Pl/SQL Paket Inline Belgeleri
cevap
PlDoc'u kullandım ve onu gerçekten iyi buldum. Başka araç kullanmadım, o yüzden kıyaslayamıyorum. PlDoc'un temellerini iyi yaptığını gördüm. Biraz daha gelişmiş özellikler istedim, bu yüzden daha fazla etiket için PlDoc'a uzantı ekleyen kendi aracımızı oluşturdum. Ayrıca ben sadece onunla belgeleme yapmıyorum, ayrıca bazı PlDoc etiketlerini (ör.
PlDoc'u denemenizi ve daha sonra gereksinimlerinizi karşılamamasını öneririz. Bunu kurmak o kadar uzun sürmez ki, denemek için çok büyük bir zaman yatırımı değil.
Şu anda NaturalDocs kullanıyorum ve kurulumu kolay ve kullanımı kolay bulduk. JavaDocs gibi bir hayli fazla ve sadece PL/SQL ile kullanmama rağmen birden çok dili destekliyor. Çok yapılandırılabilir, ancak bununla uğraşmanın gerekli olmadığını fark ettim.
Muhtemelen bu aracı sizin cevabınız olmadan bulamazdım. Oldukça ulaşılabilir olsa da, ekibimizin ihtiyaç duyduğu daha katı bir çözümün olduğunu düşünüyorum. Teşekkürler! –