• úvod
  • témata
  • události
  • tržiště
  • diskuze
  • nástěnka
  • přihlásit
    registrace
    ztracené heslo?
    KOJAProgramovani 40+
    Diskuze o obzive programovanim pro starsi a pokrocile.
    rozbalit záhlaví
    JANFROG
    JANFROG --- ---
    KOJA:
    > Podobne u slozitejsich algoritmu-proste si precist...

    Nech me hadat: dominator tree / loop detector? Pokud ano, zajimala by me genialni optimalizace. Obavam se, ze me tohle brzo ceka take :-(
    AXTHEB
    AXTHEB --- ---
    KOJA: popsaný formát máš mít ve specce a příklady máš v testech.
    V dalším odstavci máš špatně pojmenovaný třídy, v posledním funkce (případně jsou ty funkce moc velký).

    Vycházím teda z toho, že ten kód je dobře napsaný a dobře otestovaný, no.
    SATAI
    SATAI --- ---
    KOJA: tohle je dobré mít přímo u kódu nebo ještě lépe generované.

    Třebas u nás se ze signatur, anotací a dokumentace metod na controllerech generuje OpenAPI. To pak skoro pořád někdo používá, takže je dodnes šance, že se s realitou nerozjede (nemluvě o tom, že by to v mnoha případech i způsobilo řeč IDE).
    KOJA
    KOJA --- ---
    Ja mam teda s komentarema asi dost jinou zkusenost nez vetsina… prijdou mi k nezaplaceni.

    Napr. se parsuje syntakticky velmi slozity vstup-mit nad funkci parseFoo popsany format Foo a jeste treba malou ukazku je imo super.

    Podobne kdyz je nejaka specka a ted je to implementovano jako par stovek trid, tak mit tak nejak lidsky napsano jakou entitu ze specky trida s podobnym ale ne uplne stejnym nazvem modeluje je zase k nezaplaceni.

    Podobne u slozitejsich algoritmu-proste si precist, ze hledame connected components v grafu a stavime z nich jiny graf a jeste jsme prisli na genialni optimalizaci ktera nam zadarmo prekvapive zajisti nejakou vlastnost toho novyho grafu je proste 100x lepsi nez se dozvedet, ze deklarujeme worklist a vrhneme ho do 100-radkovy bohate vetveny smycky…
    SH_PANDA
    SH_PANDA --- ---
    RUDOLF: U nas ma kazdy package svoji dokumentaci, ktera se meni s kodem, nebo alespon by se mela. Dokumentace celeho produktu se pak builduje z tech partial dokumentaci. Pri buildu se validujou vsechny relativni linky.
    DELVIT
    DELVIT --- ---
    AXTHEB: Osobně jsem si jednu dobu myslel něco obdobného, ale změnil jsem názor. Vhodný komentář na příhodném místě může ušetřit spousty času při hledání chyb.
    NOHOUS
    NOHOUS --- ---
    jake jsou takhle po te 40 vase aplikacni domeny? co mezioborovy presah?
    ALMAD
    ALMAD --- ---
    AXTHEB: Jo, tohle je vlastne imho metrika pro psani komentaru, “kdyz se neco zmeni jinde, zneplatni to ten komentar co pisu?”
    FARIN
    FARIN --- ---
    PISKVOR: Rekl bych ze to je presne ten typ komentare ktery u nas nejcasteji piseme.

    Tj situace kde na prvni pohled by byla chut to refaktorovat / zjednodust protoze to prece nedava smysl. Ale je tam bohuzel nejaky skryty duvod, at uz je produktovy nebo ciste technicky.

    Ostatni situace se snazim radeji samo-dokumentovat treba trochu vic verbose namingem, pokud to jde.
    GARFIELD
    GARFIELD --- ---
    JINX: Neporadim (mam Kinesis). Ale kdyz zminujes Omakub, tak mi prijde docela funny, ze DHH pred par dny o Keychronech (negativne) psal:

    Finding acoustical delight in THE THOCK
    https://world.hey.com/dhh/finding-acoustical-delight-in-the-thock-aa84f70b
    AXTHEB
    AXTHEB --- ---
    VOY: Ted mi není jasné, jestli si četl celou diskuzi. Např.
    AXTHEB
    PISKVOR
    AXTHEB
    JINX
    JINX --- ---
    Jak je na tom ergonomie u Keychron klavesnic? Idealně Q1 Pro a podobne modely? Zatim pouzivam old kovovou Apple klavesnici a uvazuju nad necim kde by se psalo lepe a pokud mozno by mi to nezpusobilo karpaly po par mesicich pouzivani.

    BTW: co se tyce produktivniho desktopu pokud jeste neznate tak OMAKUB vypada zajimave: https://omakub.org/ obcas si s tim hraju na jednom z pracovnich pocitacu a prijde mi to jako dobry napad.
    VOY
    VOY --- ---
    AXTHEB: Jasne, komentare se muzou rozbit na milion zpusobu. Ale co vlastne hajis, ze je proto nikdy nema smysl psat?
    KLEINZACH
    KLEINZACH --- ---
    MLEKAR_STEIN: jsem taky zatizenej na trackpoint klavesnici (mam dve desktopovy + thinkpad), protoze nemusim sundavat ruku z mysi, kdyz ji moc nepotrebuju. cloveka to trosku omezuje ve vyberu notebooku (musim mit stejnou kb vsude) a jednou za cas, pri vymene za novou generaci, clovek trpi, pac trosku prehazou klavesy. se soucasnou generaci jsem spokojenej (ta predtim byla dementni, nemela oddeleny Fx klavesy malou mezerou, ta predtim predtim mela ten debilni touchpad, kterej sem musel vypinat, ale jinak byla ok).

    co mi na ty desktopovy verzi chybi je podsviceni, z thinkpadu sem si na to rychle zvyk.
    AXTHEB
    AXTHEB --- ---
    QWWERTY: To je úplně jedno, jakým způsobem se komentář v kódu odchýlí od reality. Problém je v tom, že komentáře v kódu nikdy nikdo neudržuje, případně změny, které ten komentář zneplatní proběhnou někde úplně jinde.
    SULTHAN
    SULTHAN --- ---
    NAVARA: Bylo to slíbeno, ale neudělalo se to.
    RUDOLF
    RUDOLF --- ---
    SULTHAN: Naše korporátní SDLC požaduje, že všechna dokumentace byla v centrálním doc repository. Jediný odkazy co povolili jsou z dokumentaci je do naší git repository, protože je tam historie. Nebo když chceme referencovat vendora. Odkazy do confluence zakázali. Přišlo mi to trochu moc, ale po čtyřech letech - kdy jsme přešli z bitbucket na github, dvakrát se změnil repozitář v kterém dokumentace je a vidím, jak se hýbou různý části ekosystému. Tak rozumím, že to ani jinak nejde;-)

    Ale má to výhodu, pokud něco má CI, tak k tomu najdu i dokumentaci v centrálním systému. Problém, je získat CI;-) Ale za ty roky udělali i kvalitní vyhledávání v centrálním repozitáři dokumentace. Bohužel, jak budoucnost není rozprostřena rovnoměrna, tak i stav různých služeb je v rozptylu moderní služba versus horor z devadesátkových let, který i po upgrade, to posunul z hororu z osmdesátých let. Nějak chápu, že ukočírovat ten šílený interní model, co vznikal desítky let je práce a přitom zachovat očekávané depence je na deset+ let.

    Imho IT firmy mají výhody, že si nenesou některý IT nánosy od šedesátých let.
    NAVARA
    NAVARA --- ---
    SULTHAN: Což tedy nenechat na původní doméně jednoduchou proxy s redirectem (a zachycení používaných adres, které je potřeba někde upravit), je imo design fail :)
    JANFROG
    JANFROG --- ---
    "future bugs" - love it!
    QWWERTY
    QWWERTY --- ---
    AXTHEB: imho to nejsou "future lies", ale spis technicky dluh. dokumentace se proste musi aktualizovat a patchovat uplne stejne jako zbytek kodu
    a nebo by jsi mohl kod prebrandovat na "future bugs" :))
    AXTHEB
    AXTHEB --- ---
    SULTHAN: Vždyť to říkám, Future lies.
    SULTHAN
    SULTHAN --- ---
    AXTHEB: Jenom k těm externím odkazům do dokumentace bych měl takovou klasickou legrační příhodu, že se u nás před nedávnem migrovala confluence a jira do cloudové verze, která má samozřejmě úplně jiné adresy, takže naše všechny odkazy do dokumentace přestaly fungovat.
    SHARKIE
    SHARKIE --- ---
    VYHULENY_UFO: Mam tiez nejaku obycajnu, v praci aj doma. Mys taky. Vlastne to bude oboje nejaky ten zakladny set. Ale ja mam male ruky, tak mi zatial asi najviac vyhovovali tie mini cestovne. Jedine, co som sa naucila, bolo striedat ruky, ked je zrovna treba.
    Kliknutím sem můžete změnit nastavení reklam