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
Inline Feedbacks
Zobrazit všechny komentáře
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.

Robots.txt nestačí. AI crawleři mění, jak weby chrání obsah

Robots.txt zůstává základní signál pro slušné crawlery, ale už neumí popsat hlavní problém: stejný veřejný obsah může sloužit klasickému vyhledávání, AI odpovědím, tréninku modelů i načtení na pokyn uživatele. Provozovatel webu proto musí oddělit účel přístupu, ověřovat identitu botů, měřit dopad na infrastrukturu a u hodnotného obsahu řešit i vynucení pravidel mimo samotný robots.txt.

Jak funguje WordPress Cron a proč občas selhává

„Cron mi nějak neběhá." Klasická věta, která ve WordPress světě může znamenat cokoli od špatně nastavené WP_SITEURL, přes loopback zablokovaný Cloudflarem, až po fatal error v callbacku, který nechal viset transient doing_cron. WP-Cron totiž není skutečný scheduler — je to pseudo-cron závislý na návštěvnosti webu a HTTP loopbacku, se všemi pastmi, které si dokážete představit. Tenhle článek je hloubkový průchod jeho vnitřnostmi: co se reálně děje při spawn_cron(), kde vznikají race conditions, proč selhává a čím ho v produkci nahradit.