«documentation» etiketlenmiş sorular

Yazılım belgeleri, bilgisayar yazılımına eşlik eden yazılı metindir. Yazılımın nasıl çalıştığını, nasıl kurulacağını, nasıl kullanılacağını ve yardım için diğer kaynakları açıklar.

4
Ortaklaşa düzenlenmiş bir HTML / JS / DOM referansı oluşturma çabaları var mı?
W3Schools , eksik, bazen yanlış ve reklam ile basmış olma üne sahiptir; yine de, bir SO sorusunu yanıtlarken bazı şeyleri aramak veya belgelere bağlantı ararken, hala tek kullanışlı tarayıcı kaynağıdır. JavaScript'i belgelemek için giderek daha büyük bir iş yapan Mozilla Geliştirici Ağı ve efsanevi ve harika Quirksmode gibi başka kaynaklar …

2
Programlama dilini belgeleme: Referans Kılavuzu
Ürün yelpazemizdeki dokümantasyonun yenilenmesine bakıyoruz. Bunun bir kısmı, sistemin bir parçası olarak kullanılan bir programlama dili için referans kılavuzları içerir . Bir programlama dili için referans kılavuzu yazarken, dili yeni olanlar için maksimum kullanılabilirlik için yapılandırmanın en iyi yolu nedir? Belgelenen her bir anahtar kelimenin temel özellikleri nelerdir ? Sözdizimi …

2
Bir dosya biçimi belirtimi nasıl belgelenir [kapalı]
Kapalı . Bu sorunun daha fazla odaklanması gerekiyor . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Soruyu, yalnızca bu yayını düzenleyerek tek bir soruna odaklanacak şekilde güncelleyin . 6 yıl önce kapalı . Bir proje için, bazı eski oyunlardan ve ilgili yazılımlardan - yapılandırma dosyaları, tasarruflar, kaynak …

6
İş kuralları nasıl belgelenir
İş kurallarını belgelemenin resmi ve en çok uygulanan yönteminin ne olacağını merak ediyorum? Ayrıca geliştirme yapay nesnelerinin kullanıcı arabirimi özelliklerini nasıl belgelersiniz (örn. Form alanlarını belgelendirme ve düğmelerin form, bilgi metni vb. Üzerinde nasıl davrandığı)

6
Geliştirme sonrasında bir Yazılım Tasarım Belgesi oluşturmak haklı olabilir mi?
Şu anda harici bir şirkette bireysel olarak karmaşık yazılım geliştirmem gereken "Yazılım Geliştirme" çalışmalarım için mezuniyetim üzerinde çalışıyorum. Tüm bunların, ilgili tüm belgeleri oluşturarak yapılandırılmış bir şekilde yapılması gerekir. Bu proje için IEEE standart belgeleriyle çalışmayı seçtim: Yazılım Gereksinimleri Belgesi (SRS), Yazılım Mimarisi Belgeleri (SAD) ve Yazılım Tasarım Belgesi (SDD). …

1
Kaynak kodunu yorumlamanın yazılım kalitesi, sürdürülebilirlik ve geliştirici verimliliği üzerindeki etkileri hakkında ampirik çalışmalar var mı? [kapalı]
Kapalı. Bu soru konu dışı . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Soruyu Yazılım Mühendisliği Yığın Değişimi için konuyla ilgili olacak şekilde güncelleyin . 6 yıl önce kapalı . Kaynak kodu ve yazılım ürünlerini belgelemenin savunucusuyum. Benim kişisel deneyimim ve gözlemlerim, titizlikle yorumlanan kaynak kodları üzerinde …


1
Yinelemeli dokümantasyon geliştirme mümkün mü ve etkili dokümantasyon sağlıyor mu?
Üniversite için hemen başlamayacağım, ancak oldukça uzun bir süredir düşündüğüm bir projem var. Üniversite proje geliştirmesinin sanayi gibi olmadığını anlıyorum (şu anda kendim stajyerim), bu yüzden şu anda işaret edeceğim durum muhtemelen gerçek yazılım geliştiricileri için biraz saçma görünecektir. ^^' Projenin kendisi, çalışmalarımızın çoğunu belgelememizi gerektiriyor. Bu nedenle, bazı işaretlere …

4
Hesaplama açısından yoğun olan kodu “tanıma dışında optimize edilmiş” belgelemek ve öğretmek nasıl?
Bazen, en ağır düşük düzeyli optimizasyona ihtiyaç duyan, yeterince yoğun olan kodun% 1'i vardır. Genel olarak video işleme, görüntü işleme ve her türlü sinyal işleme örnek gösterilebilir. Amaçlar , kodun sürdürülemez hale gelmemesi ve yeni geliştiriciler tarafından kaldırılmaya eğilimli hale gelmemesi için optimizasyon tekniklerini belgelemek ve öğretmektir . (*) (*) …

5
Bir web uygulaması için müşteriye verilecek çıktılar nelerdir? [kapalı]
Kapalı . Bu sorunun daha fazla odaklanması gerekiyor . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Soruyu, yalnızca bu yayını düzenleyerek tek bir soruna odaklanacak şekilde güncelleyin . 4 yıl önce kapalı . Temelde PHP'de geliştirilen ve başka bir normal web uygulaması olan bir web uygulamasını tamamladım. …

4
Açık kaynak projeleri, tasarımları veya mimarileri hakkında dokümantasyon olmadan nasıl başarılı olabilir?
Ünlü açık kaynaklı projeleri inceleyerek programlama becerilerimi geliştirmek istiyorum, ancak kaynak kodlarına atlayarak kaybolmanın kolay olduğunu düşünüyorum. Bu yüzden önce kodlarının organizasyonu hakkında genel bir fikir edinmek için tasarımları veya mimarileri (UML diyagramları gibi) hakkındaki belgelerini okumaya karar verdim. Ancak, sürpriz olarak, Hibernate, Spring, ASP.NET MVC, Rails, vb. Gibi büyük …

3
Yüksek Kaliteli Yazılım Önerileri Yazma [kapalı]
Kapalı . Bu sorunun daha fazla odaklanması gerekiyor . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Soruyu, yalnızca bu yayını düzenleyerek tek bir soruna odaklanacak şekilde güncelleyin . 5 yıl önce kapalı . Son zamanlarda yazılım projeleri için bazı öneriler okudum ve gördüklerimden biraz endişeliyim. Genellikle tekliflerin …

9
Önce Kod Belgeleri? [kapalı]
Kapalı . Bu soru görüş temelli . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Bu yayını düzenleyerek gerçekler ve alıntılarla yanıtlanabilmesi için soruyu güncelleyin . 2 yıl önce kapalı . Kod yazmadan önce, önce kod kodunu oluşturmaya çalışan var mı? Bunu daha önce düşünüyordum çünkü somut bir …


9
Kod dökümantasyonu verimlilik kazançları / kayıpları üzerine çalışmalar
Çok fazla arama yaptıktan sonra, yazılım geliştirme dünyasında bilinen bir varsayımla ilgili temel bir soruya cevap veremedim: NE BİLİNİYOR: Yeterli kod dokümantasyonu (Doxygen etiketleri, Javadoc ya da sadece çok sayıda yorum olsun) konusunda katı bir politika uygulamak, kod geliştirmek için gereken süreye ek yük getirir. FAKAT: Kapsamlı belgelere (hatta bir …

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.