Yazılım dökümantasyonu oluşturma aracı

Question

Merhaba.
Geliştirdiğimiz web, masaüstü, mobil vs. yazılımların dökümantasyonunu oluşturabileceğimiz güvenli, basit ve opensource araç var mı? İnternet üzerinde araştırıyorum ancak çoğu sistemin kullandığı araçlardan bulamadım.
Bilgisi olan paylaşabilir mi?

tristy · Answer

Takipteyim.

Qazwss · Answer

https://docsify.js.org/#/ bu konuda iyidir.

emrahe · Answer

Qazwss adlı üyeden alıntı:						mesajı görüntüle									https://docsify.js.org/#/ bu konuda iyidir. 		Teşekkür ederim, inceliyorum.

hesapadim · Answer

swagger.io

emrahe · Answer

hesapadim adlı üyeden alıntı:						mesajı görüntüle									swagger.io 		Bunu Asp.Net MVC Web API'de otomatik olarak kullanıyorum. Yazılım dökümantasyonu oluşturulabiliyor mu?

hesapadim · Answer

emrahe adlı üyeden alıntı:						mesajı görüntüle									Bunu Asp.Net MVC Web API'de otomatik olarak kullanıyorum. Yazılım dökümantasyonu oluşturulabiliyor mu? 		evet html seçerseniz dökümantasyon veriyordu

mobilecom · Answer

hesapadim adlı üyeden alıntı:						mesajı görüntüle									evet html seçerseniz dökümantasyon veriyordu 		Arkadaşın bahsettiği başka bir şey, vs da summary leri düzgün eklerseniz , daha sonra xml olarak çıktı alabilirsiniz onuda HTML convert yaptınız mı mis gibi döküman olur elinizde

emrahe · Answer

mobilecom adlı üyeden alıntı:						mesajı görüntüle									Arkadaşın bahsettiği başka bir şey, vs da summary leri düzgün eklerseniz , daha sonra xml olarak çıktı alabilirsiniz onuda HTML convert yaptınız mı mis gibi döküman olur elinizde 		Evet, çünkü binlerce satır kod var. Herhangi bir yerinde güncelleme yapıldığında tekrar dökümana gidip güncelleme yapmak yerine, kodlarda summary olarak eklediklerimi dökümana çevirebilecek araç lazım. Swagger apilerde güzel çalışıyor. Diğer sürümleri ücretli olduğu için denemedim.

emrahe · Answer

@tristy; 
Güzel araç ancak ücretli. Microsoftun dökümanlarındakine benziyor. Microsoftta mı bunu kullandı diye düşündürdü 
https://marketplace.visualstudio.com...Macej.VSdocman

Güncelleme:
Microsoftun web sitesinde yayınlanan  DocFX ve Sandcastle denedim. Sandcastle oldukça kullanışlı. Şuanda program genelinde xml summary güncelliyorum. Çıktıları ve detaylandırmalarını beğendim. Tavsiye ederim.
https://docs.microsoft.com/en-us/dot...ation-comments

tristy · Answer

emrahe adlı üyeden alıntı:						mesajı görüntüle									@tristy;
Güzel araç ancak ücretli. Microsoftun dökümanlarındakine benziyor. Microsoftta mı bunu kullandı diye düşündürdü 
https://marketplace.visualstudio.com...Macej.VSdocman

Güncelleme:
Microsoftun web sitesinde yayınlanan DocFX ve Sandcastle denedim. Sandcastle oldukça kullanışlı. Şuanda program genelinde xml summary güncelliyorum. Çıktıları ve detaylandırmalarını beğendim. Tavsiye ederim.
https://docs.microsoft.com/en-us/dot...ation-comments 		Paylasim icin tesekkurler. Kesinlikle ise yarayacaktir.

VipTema · Answer

https://www.gitbook.com/ kullanabilirsin. Dokumantasyonu hazirladiktan sonra subdomain bağlayabilirsin. Hem online hem sıfır kod bilgisi tamamen markdown

Turumaji · Answer

Önerilenler hep yazılım için, peki SaSS sistem dökümantasyonu için bir araç varmı ? 
yani kullanıcıya nereye basıcağını ve ya menüleri anlatmak için birşey...
Ekran görüntüsü alıp adobe illustrastorden yapıyorum fakat düzgün bir yöntem/araç varsa iyi olur

SEOmuhendisi · Answer

hocam merhaba

kişisel gelişim amaçlı soruyorum tamamen, örnek siteleri inceledim ama tam anlayamadım, bunlar tam olarak ne yapıyor