abclinuxu.cz AbcLinuxu.cz itbiz.cz ITBiz.cz HDmag.cz HDmag.cz abcprace.cz AbcPráce.cz
AbcLinuxu hledá autory!
Inzerujte na AbcPráce.cz od 950 Kč
Rozšířené hledání
×
    včera 17:33 | Nová verze

    Byla vydána (𝕏) nová verze 2025.2 linuxové distribuce navržené pro digitální forenzní analýzu a penetrační testování Kali Linux (Wikipedie). Přehled novinek se seznamem nových nástrojů v oficiálním oznámení na blogu.

    Ladislav Hagara | Komentářů: 0
    včera 10:33 | Komunita

    Dánské ministerstvo pro digitální záležitosti má v plánu přejít na Linux a LibreOffice [It's FOSS News].

    Ladislav Hagara | Komentářů: 8
    včera 09:22 | Komunita

    V úterý Google vydal Android 16. Zdrojové kódy jsou k dispozici na AOSP (Android Open Source Project). Chybí (zatím?) ale zdrojové kódy specifické pro telefony Pixel od Googlu. Projekty jako CalyxOS a GrapheneOS řeší, jak tyto telefony nadále podporovat. Nejistá je podpora budoucích Pixelů. Souvisí to s hrozícím rozdělením Googlu (Google, Chrome, Android)?

    Ladislav Hagara | Komentářů: 2
    12.6. 20:22 | Nová verze

    Byla vydána (𝕏) květnová aktualizace aneb nová verze 1.101 editoru zdrojových kódů Visual Studio Code (Wikipedie). Přehled novinek i s náhledy a videi v poznámkách k vydání. Ve verzi 1.101 vyjde také VSCodium, tj. komunitní sestavení Visual Studia Code bez telemetrie a licenčních podmínek Microsoftu.

    Ladislav Hagara | Komentářů: 0
    12.6. 10:00 | Komunita

    V Brně na FIT VUT probíhá třídenní open source komunitní konference DevConf.CZ 2025. Vstup je zdarma, nutná je ale registrace. Na programu je celá řada zajímavých přednášek, lightning talků, meetupů a workshopů. Přednášky lze sledovat i online na YouTube kanálu konference. Aktuální dění lze sledovat na Matrixu, 𝕏 nebo Mastodonu.

    Ladislav Hagara | Komentářů: 0
    12.6. 09:44 | IT novinky

    Vyloučení technologií, které by mohly představovat bezpečnostní riziko pro stát, má umožnit zákon o kybernetické bezpečnosti, který včera Senát schválil spolu s novelami navazujících právních předpisů. Norma, kterou nyní dostane k podpisu prezident, počítá rovněž s prověřováním dodavatelů technologií pro stát. Normy mají nabýt účinnosti od třetího měsíce po jejich vyhlášení ve Sbírce zákonů.

    Ladislav Hagara | Komentářů: 4
    12.6. 01:11 | Nová verze

    Open source platforma Home Assistant (Demo, GitHub, Wikipedie) pro monitorování a řízení inteligentní domácnosti byla vydána v nové verzi 2025.6.

    Ladislav Hagara | Komentářů: 0
    12.6. 00:55 | Nová verze

    Po Red Hat Enterprise Linuxu a AlmaLinuxu byl v nové stabilní verzi 10.0 vydán také Rocky Linux. Přehled novinek v poznámkách k vydání.

    Ladislav Hagara | Komentářů: 0
    11.6. 22:55 | Nová verze

    Bylo vydáno Eclipse IDE 2025-06 aneb Eclipse 4.36. Představení novinek tohoto integrovaného vývojového prostředí také na YouTube.

    Ladislav Hagara | Komentářů: 0
    11.6. 22:33 | IT novinky

    Americká filmová studia Walt Disney a Universal Pictures podala žalobu na provozovatele populárního generátoru obrázků pomocí umělé inteligence (AI) Midjourney. Zdůvodňují to údajným porušováním autorských práv. V žalobě podané u federálního soudu v Los Angeles označují firmu za „bezednou jámu plagiátorství“, neboť podle nich bez povolení bezostyšně kopíruje a šíří postavy z filmů jako Star Wars, Ledové království nebo Já, padouch, aniž by do nich investovala jediný cent.

    Ladislav Hagara | Komentářů: 1
    Jaký je váš oblíbený skriptovací jazyk?
     (56%)
     (31%)
     (7%)
     (2%)
     (0%)
     (1%)
     (3%)
    Celkem 261 hlasů
     Komentářů: 16, poslední 8.6. 21:05
    Rozcestník

    Používáte ještě Javadoc dokumentaci?

    2.8.2010 10:08 | Přečteno: 1773× | poslední úprava: 2.8.2010 11:08

    Jednou z výhod Javy jsou standardní nástroje, v neposlední řadě pak Javadoc. V posledních letech ale nastala exploze IDE a opensource knihoven. Mnohdy je pak jednodušší studovat zdrojáky přímo.

    Takže mám jednoduchou otázku: Kdy jste naposledy otevřeli dokumentaci generovanou Javadocu? U mě je to hodně sporadické, většinou mi odkaz na vyjede z Google a i v tom případě se snažím najít originální zdroják. Není to závislé na kvalitě dokumentace, spíš jsem si už zvyknul číst zdroják. Jediná výjimka jsou closedsource knihovny, ale ty používám hodně sporadicky.

    Důvod proč se ptám: přemýšlím o migraci jednoho projektu do jazyku Scala. Jednou z překážek je dokumentační nástroj. Scala má něco podobného s názvem Scaladoc, ale ten se neintegruje s Javadocem. Vznikne mix dvou jazyků z nichž každý bude mít jiný dokumentační nástroj a oddělenou dokumentaci. A jedním z řešení je prostě žádný *Doc nemít a odkázat rovnou na zdrojové kódy.        

    Hodnocení: 75 %

            špatnédobré        

    Anketa

    Používáte javadoc?
     (73 %)
     (9 %)
     (6 %)
     (6 %)
     (6 %)
    Celkem 67 hlasů

    Tiskni Sdílej: Linkuj Jaggni to Vybrali.sme.sk Google Del.icio.us Facebook

    Komentáře

    Vložit další komentář

    2.8.2010 10:21 podlesh | skóre: 38 | Freiburg im Breisgau
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    Někdy člověk zdrojáky nemá (proprietární knihovny) a pak je rád i za javadoc. Samozřejmě je to většinou k ničemu, knihovna s dostatečně popsaným API je vzácnou výjimkou - proto je lepší se držet opensource.
    2.8.2010 10:23 Filip Jirsák | skóre: 68 | blog: Fa & Bi
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    Ve zdrojáku je zbytečně moc podrobností. Nejčastěji stačí názvy tříd a metod, pak případně JavaDoc. Do zdrojáku koukám až když v JavaDocu něco chybí, když je to přílišný detail na to, aby to bylo v dokumentaci, případně když ta knihovna dělá zjevně něco jiného, než co tvrdí dokumentace.
    2.8.2010 10:43 void
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    IMHO dochází v textu k záměně Javadocu a jeho výstupu. A co se týče IDE, myslím si, že aspoň nějaká Javadoc používají "v pozadí".
    2.8.2010 11:11 Trained.Monkey | skóre: 12 | blog: monkey
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    Upravil jsem text aby se to nepletlo.
    2.8.2010 11:17 void
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    OK. Já čtu Javadoc dokumentaci každý den, kdy (v Javě) programuju.
    2.8.2010 10:48 Ladicek | skóre: 28 | blog: variace | Havlíčkův brod
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    Nevím teda, jak to autor myslí, ale výstupy javadocu prakticky nečtu. Nechávám si dokumentaci zobrazovat IDEčkem, které ji z dokumentačních komentářů ve zdrojácích formátuje výrazně hezčeji :-)
    Ještě na tom nejsem tak špatně, abych četl Viewegha.
    xkucf03 avatar 2.8.2010 17:40 xkucf03 | skóre: 49 | blog: xkucf03
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc?
    +1
    Mám rád, když se lidé přou, znamená to, že vědí, co dělají, a že mají směr. Frantovo.cz, SQL-DK, Relational pipes
    2.8.2010 16:24 rudyment
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?
    Javadoc proletím mnohem rychleji a když je slušně napsaný, dá se i lépe číst. Ke zdrojáku se obracím až tehdy, když je mi v Javadocu něco nejasné.
    xkucf03 avatar 2.8.2010 17:39 xkucf03 | skóre: 49 | blog: xkucf03
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?
    Počítá se v anketě do „Ano, prakticky pořád“ i čtení Javadocu přes IDE? Že bych si pročítal JavaDoc jako HTML stránky, to moc ne, ale v IDE jako kontextovou nápovědu ho používám pořád – jde hlavně o ty komentáře a anotace, než o to vygenerované HTML. Zdrojáky jsou fajn (a asi bych ani knihovnu bez zdrojáků nepoužíval), ale není nutné se do nich pořád koukat – resp. dobrá knihovna by měla mít dobře navržené a zdokumentované rozhraní, abych z něj chápal, co mají jednotlivé metody dělat a k čemu slouží jednotlivé třídy – do jejich zdrojáků se budu dívat, až je budu chtít upravit, inspirovat se, hledat chybu… ale pro běžné používání by neměly být potřeba.
    Mám rád, když se lidé přou, znamená to, že vědí, co dělají, a že mají směr. Frantovo.cz, SQL-DK, Relational pipes
    2.8.2010 21:21 Leoš Literák | skóre: 74 | blog: LL | Praha
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?
    jo, ale stve me, jak byvaji odflaknute, takze nekdy nezbyde, nez ztracet cas ctenim kodu
    Zakladatel tohoto portálu. Twitter, LinkedIn, blog, StackOverflow
    2.8.2010 22:28 lok
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?
    Javadoc pouzivam velmi sporadicky. Myslim, ze doxygen je lepsi volbou. Btw nezvladl by doxygen vygenerovat dokumentaci pro obe casti tveho projektu (jak java tak scala)?
    3.8.2010 11:04 Trained.Monkey | skóre: 12 | blog: monkey
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?
    Asi ne, Skala je v tomhle trochu divna, napriklad ma vicenasobnou dedicnost (traits).
    3.8.2010 05:17 Andrej | skóre: 51 | blog: Republic of Mordor
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?

    JavaDoc a Doxygen jsou nezbytnost. Vždyť právě díky nim je IDE užitečné. Pokud například používám nějakou standardní knihovnu, prolézání zdrojáků mě až tak moc nezajímá. Naopak možnost přečíst si ihned u každé vonalé funkce její dokumentaci je přímo k nezaplacení.

    3.8.2010 14:02 Trained.Monkey | skóre: 12 | blog: monkey
    Rozbalit Rozbalit vše Re: Používáte ještě Javadoc dokumentaci?
    Nechal jsem si to projit v hlave. Nejsem moc dobry ve psani javadocu znacek. Rozhodne ma dokumentace neni dost dobra, aby se z ni dalo vycist chovani v neobvyklych prikladech.

    Takze misto toho se vic soustredim na priklady a unit testy. Do dokumentace tak misto odkazu na vystup z javadocu dam odkaz na priklad pouziti.

    Založit nové vláknoNahoru

    ISSN 1214-1267   www.czech-server.cz
    © 1999-2015 Nitemedia s. r. o. Všechna práva vyhrazena.