Sandcastle és társai
Az NDoc halott, van helyette SandCastle. Nagyon jó, imádom. Ezzel csinálják a VS doksiját is. Van még kétely valakiben?
Az is jó, hogy nem kell kézzel írnom a konfigját, mert van hozzá Sandcastle Help File Builder, ami hasonló GUI, mint az ndochoz volt.
Aztán, hogy ne kelljen sokat gépelni az xml kommenteket, ott a GhostDoc. Beépül a VS-be, és CTRL-ALT-D-vel létrehoz egy komment vázat az adott kódrészhez. Meglepően ügyesen, ha angol neveket használunk a kódban.
Mindhárom eszköz zseniális és INGYENES. Aki ezek után nem dokumentálja a kódját, annak 1-es. :)
September 30th, 2009 at 11:56 pm
Ctrl-Alt-D? Bonyolult. Jobb IDE-k mar a tripla perjelre feldobjak a dokumentacios vazat. Az mindig csak 1 billentyu, igaz haromszor kell megnyomni, de meg mindig gyorsabb, mint billkombot nyomni.
October 1st, 2009 at 7:05 am
Fogom az élcet, de nem. :)
A VS tud alapban komment vázat generálni, de nézd meg a fenti programot, és rájössz, hogy van értelme a 3 billentyűnek, messze nem ugyanaz a kettő.
October 1st, 2009 at 2:07 pm
A GhostDoc-ban még az a jó, hogy - mint minden humán nyelvvel zsonglőrködő gép eszköz - néha nagyon vicces tud lenni. :)
October 1st, 2009 at 11:21 pm
Nyehem, de annak aki azzal generálja bele a kommentet és már csekkeli is be … ejnye bejnye.
(Én azt szeretem nagyon, hogy egy már kommentezett interfész vagy ős kommentjeit átmásolja a leszármaztatott metódus kommentnek.)
October 2nd, 2009 at 5:20 am
@Soczó Zsolt: igen, pontosan errol beszeltem. Ugyan nem probaltam meg ki a programot, de igy latatlanban is pontosan sejtem, mik lehetnek a kulonbsegek a ketto kozt (parameterlista felderitese, esetleg a metodusnev belerakasa a dokumentacios kommentbe, stb.). Az igazan cool az lenne, ha a VS beepitett kommentgeneralo cuccat biralna felul. Vagy legalabb integralasra kerulne a kovetkezo VS SP-be.
October 2nd, 2009 at 7:24 am
@gerleim: Persze. Ez egyébként is csak váz, még ha sikerül is szintaktikailag / szematikailag épkézláb mondatot összehozni, önmagában sok információt nem tartalmaz (public Foo GetFoo() -> “Gets the Foo”, köszi, sejtettem amúgy is; az msdn-ben is ezeket a magyarázatokat szeretem a legjobban).