Přejít k navigační liště

Zdroják » Zprávičky » Tvoříme programátorskou dokumentaci

Tvoříme programátorskou dokumentaci

Zprávičky Různé

Nálepky:

Každý, kdo kdy psal nějaký kód, určený pro ostatní vývojáře, zákonitě narazil na otázku dokumentace. Jak má vypadat, co v ní má být, jakou formou…? Kvalitní dokumentace může vaši knihovnu protlačit mezi lidi, nebo naopak totálně pohřbít, možná spolehlivěji než kvalita či nekvalita vlastního kódu. Nad problémy spojenými s tvorbou programátorské dokumentace se zamýšlí Jan Novotný na svém blogu.

Komentáře

Odebírat
Upozornit na
guest
4 Komentářů
Nejstarší
Nejnovější Most Voted
vd

„nějakou kód“ ? :)

novoj

Hmm, bohužel za tenhle překlep může redakce, která upravila mnou původně navrhovaný text. Bohužel už nemám právo to zpětně korekturovat, takže s tím nemůžu nic udělat. Bude se to tedy muset přežít ;-)

Martin Malý

Redakce děkuje za upozornění a autorovi se omlouváme…

novoj

Díky moc, já děkuju hlavně za rychlé zveřejnění. Překlep se prostě přihodí ani člověk neví jak.

Co je nového v Gitu 2.55.0

Git 2.55.0 přináší šest zajímavých novinek – od dlouho očekávané podpory fsmonitoru na Linuxu, přes zjednodušení úprav historie commitů pomocí nového příkazu git history fixup, až po další krok v postupné integraci jazyka Rust do jádra Gitu. Přidává se i možnost pushovat do skupiny vzdálených repozitářů, omezit šířku grafu u git log --graph a zrychlit git grep a git cherry v částečných klonech.

Od statických stránek k edge computingu: Historie webových technologií za 30 let

Třicet let. Tak dlouho už web existuje v podobě, kterou bychom dnes alespoň zhruba poznali — od prvních statických dokumentů přes éru aplikací běžících v prohlížeči až po kód, který se spouští na stovkách míst po celém světě jen pár milisekund od uživatele. Tenhle příběh ale není jen suchým výčtem technologií a verzí. Je to příběh jednoho kyvadla, které se celé tři dekády houpe mezi serverem a klientem — a které právě teď nachází nový bod rovnováhy někde uprostřed, na okraji sítě.