DevProTalk

DevProTalk (http://www.devprotalk.com/index.php)
-   Web aplikacije, web servisi i software (http://www.devprotalk.com/forumdisplay.php?f=30)
-   -   App za pisanje dokumentacije (http://www.devprotalk.com/showthread.php?t=9414)

dinke 02. 12. 2010. 20:55

App za pisanje dokumentacije
 
Dakle kao sto sam naslov kaze, treba mi neka preporuka za soft za pisanje dokumentacije, pri cemu ce istu da pise jedno 10-tak ljudi. Do sada smo koristili (tj. nismo :) ) dokuwiki, pitam se postoji li nesto bolje od toga.

mangia 02. 12. 2010. 21:06

I mene zanima. Takođe, kako korisnike natjerati da čitaju dokumentaciju ???

bluesman 02. 12. 2010. 21:12

Ima, ali neću da ti kažem :) Pronašli su ovi moji nešto što super izgleda - uradiću edit kada saznam kako se zove.

Edit: Markdown http://daringfireball.net/projects/markdown/

Hvala Dejanu R :)

dejanr 02. 12. 2010. 23:18

Ja naleteo na mdocs https://github.com/jaywilliams/mdocs , php script koji parsira markdown file-ove, generise toc na osnovu headings-a i meni na osnovu direktorijuma i file-ova, pritom koristi i geshi za syntax highlithing.

Probali i mi dokuwiki i bas je bilo mucenje, dosta je jednostavnije editovati tekstualne fajlove, komitujes i sve je up.

ajankovic 02. 12. 2010. 23:53

Dokumentaciju ne bi trebalo odvajati od koda.

doxygen je lek :).

dinke 03. 12. 2010. 00:48

^ Ma mi koristimo phpdocumentor za to, ali ne moze kod da objasni strukturu baze, linkove u projektu, kako, zasto itd. itd. da ne ulazim u detalje.

Do sada smo koristili dokuwiki (tj. ja sam koristio, niko drugi u firmi nije pisao dokumentaciju), koji je onako ... ja ga nikada nisam preterano gotivio ali nista bolje nisam nasao.

DejanVesic 03. 12. 2010. 21:42

A što ne koristite Google Docs?

Može eksport u bilo šta, može kolaboracija, može maltene šta god hoćeš ...


Vreme je GMT +2. Trenutno vreme je 10:47.

Powered by vBulletin® Verzija 3.6.8
Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.
Copyright © DevProTalk. All Rights Reserved.

Mišljenja, saveti, izjave, ponude ili druge informacije ili sadržaji nastali na Sajtu su vlasništvo onoga ko ih je kreirao, a ne DevProTalk.com, tako da ne morate da se oslanjate na njih.
Autori poruka su jedini odgovorni za ovakve sadržaje. DevProTalk.com ne garantuje tačnost, kompletnost ili upotrebnu vrednost informacija, stavova, saveta ili datih izjava. Ne postoje uslovi pod kojima bi mi bili odgovorni za štetu ili gubitak koji je posledica bilo čijeg oslanjanja na nepouzdane informacije, ili bilo kakve informacije nastale kroz komunikaciju između registrovanih članova.
Web sajt može sadržavati linkove na druge web sajtove na Internetu ili neke druge sadržaje. Ne kontrolišemo niti podržavamo te druge web sajtove, niti smo pregledali bilo kakve sadržaje na takvim sajtovima. Mi nećemo biti odgovorni za legalnost, tačnost ili prikladnost bilo kog sadržaja, oglasa, proizvoda, usluga ili informacije lociranim na ili distribuiranih kroz druge web sajtove, niti za bilo kakvu štetu nastalu kao posledica takvih informacija. DevProTalk.com drži i čuva druga prava vlasništva na web sajtu. Web sajt sadrže materijale zaštićene copyright-om, zaštitne znakove i druge informacije o pravu vlasništva ili softver. Članovi mogu poslatu informacije zaštićene pravima vlasništva njihovih nosilaca i ona ostaju zaštićena bez obzira da li su oni koji prenose te informacije to naveli ili ne. Osim informacija koje su u javnom vlasništvu ili za koje dobijete dozvolu, nemate pravo da kopirate, modifikujete ili na bilo koji način menjate, objavljujete, prenosite, distribuirate, izvršavate, prikazujete ili prodajte bilo koju informaciju zaštićenu pravima vlasništva. Slanjem informacija ili sadržaja na bilo koji deo DevProTalk.com, Vi automatski dozvoljavate i predstavljate garanciju da imate pravo da dozvolite DevProTalk.com ili članovima DevProTalk.com bespovratnu, kontinualnu, neograničenu, globalnu dozvolu da koriste, kopiraju, izvršavaju, prikazuju i distribuiraju takve informacije i sadržaje i da iz takvih sadžaja koriste bilo koji deo u bilo koje svrhe, kao i pravo i dozvolu da koriste gore navedene sadržaje. Svi zaštitni znakovi (trademarks), logotipi, oznake usluga, firme ili imena proizvoda koji se pominju na ovom web sajtu su vlasništvo kojim raspolažu njihovi vlasnici.