Blog Changeloop

Poznámky k vydání v praxi

Dvě věci, na které hodně myslíme: jak psát poznámky k vydání, které si někdo přečte, a jak přestat udržovat changelog ručně. Žádný newsletter, žádná registrace. Jen texty.

  • Alfa vs beta testování: rozdíly a kdy co spustit

    Alfa a beta testování v porovnání: kdo testuje, jak hotový je build, uzavřená a otevřená beta, kritéria ukončení a sběr i vyřizování zpětné vazby z bety.

    Smyčka zpětné vazby6 min čtení

  • Co je hotfix? Význam, hotfix vs patch a jak ho vydat

    Hotfix je naléhavá oprava vydaná mimo běžný cyklus vydávání. Co pojem znamená, čím se liší od patche nebo bugfixu a jak ho bezpečně vydat do produkce.

    Vývoj5 min čtení

  • Kano model: třiďte požadavky podle pocitů zákazníků

    Kano model třídí funkce na základní, výkonové a nadšující pomocí dvouotázkového dotazníku. Jak ho použít na požadavky na funkce a jak číst výsledky.

    Smyčka zpětné vazby5 min čtení

  • Release candidate (RC): co znamená a jak ho vést

    Release candidate je build, který vyjde jako finální verze, pokud testy nenajdou blokující chybu. Místo RC po betě, verzování a pravidla pro ukončení.

    Vývoj4 min čtení

  • RICE skóre: vzorec, příklad a nejčastější chyby

    RICE skóre řadí nápady podle dosahu, dopadu, jistoty a pracnosti. Vzorec, příklad se čtyřmi funkcemi, hodnoty škál a chyby, které výsledek zkreslují.

    Smyčka zpětné vazby4 min čtení

  • CHANGELOG.md: co do něj patří a jak ho udržet aktuální

    CHANGELOG.md je záznam pro čtenáře o tom, co se v každé verzi změnilo. Sekce, které potřebuje, úplný příklad a jediný návyk, který ho udrží aktuální.

    Vývoj5 min čtení

  • GitHub release notes: vygenerujte je a udělejte je čitelné

    GitHub navrhne release notes ze sloučených pull requestů na jedno kliknutí. Co návrh obsahuje, jak ho tvaruje release.yml a jaká úprava ho udělá čitelným.

    Vývoj5 min čtení

  • Jak sestavit produktovou roadmapu ze zpětné vazby zákazníků

    Jak sestavit produktovou roadmapu v šesti krocích, od požadavků, které už máte. Seskupte je, seřaďte, označte jistotu a revidujte, ať zůstane pravdivá.

    Smyčka zpětné vazby5 min čtení

  • Šablona produktové roadmapy: pole ke zkopírování

    Šablona produktové roadmapy je tabulka s pevnými poli u každé položky. Zkopírujte verzi o šesti polích, vyplněný příklad a zjistěte, která pole škrtnout.

    Smyčka zpětné vazby5 min čtení

  • Verzování REST API: URL, hlavička nebo query, co se hodí

    Verzování REST API dává verzi do cesty URL, do hlavičky nebo do query stringu. Co každá volba znamená pro volající, cache a oznámení změn, s příklady.

    Změny API5 min čtení

  • Software release notes: co to je a co do nich zahrnout

    Software release notes říkají čtenáři, co se ve verzi změnilo, koho se to týká a co má udělat. Čtyři druhy, co zahrnout a ukázkový příklad zápisu.

    Poznámky k vydání v praxi4 min čtení

  • Release notes k opravám chyb: jak psát použitelné záznamy

    Release notes k opravám chyb fungují, když každý záznam uvádí příznak, koho zasáhl a další krok. Přepisy před a po, pravidla pro bezpečnost a ztrátu dat.

    Poznámky k vydání v praxi6 min čtení

  • Jak žádat o zpětnou vazbu zákazníků v softwarovém produktu

    Ptejte se na jednu konkrétní věc hned poté, co uživatel něco udělal, tam, kde pracuje. Hotová znění pro každý okamžik a špatné dotazy, kterým se vyhnout.

    Smyčka zpětné vazby6 min čtení

  • Příklady produktové roadmapy: šest formátů a jak selhávají

    Šest příkladů produktové roadmapy s realistickými položkami: Now/Next/Later, kvartální, tematická, výsledková, veřejná a release. Komu se hodí a kde selže.

    Smyčka zpětné vazby6 min čtení

  • Proces správy vydání pro týmy, které vydávají často

    Proces správy vydání pro softwarové týmy v sedmi krocích, s vlastníkem a kritérii dokončení u každého, plus metriky DORA a jedno další KPI, které sledovat.

    Vývoj7 min čtení

  • Příklady release notes pro každý druh změny

    Příklady release notes pro funkci, opravu, zásadní změnu, bezpečnost, deprekaci, obchod s aplikacemi i interní zprávu, vždy s vysvětlením, proč fungují.

    Poznámky k vydání v praxi6 min čtení

  • Verzování API Stripe: jak funguje a co z něj převzít

    Verzování API Stripe připíná každý účet k datované verzi a každý požadavek ji může přepsat. Jak funguje, co stojí a co z něj může převzít malé API.

    Změny API6 min čtení

  • Kdo píše changelog, a kdo by měl

    Kdo píše changelog? Autorka PR ví, co se změnilo, PM proč na tom záleží. Žádná sama užitečný záznam nenapíše a výchozí volba changelog nechá zastarat.

    Vývoj5 min čtení

  • Pohotovostní release notes: psaní pod časovým tlakem

    Vydání vyvolaná incidentem potřebují poznámky napsané za minuty, ne dny, a běžný proces psaní počítá s časem, který v takové chvíli vůbec nemáte.

    Poznámky k vydání v praxi4 min čtení

  • Breaking changes v Protobuf: co přežije na drátě

    Breaking changes v Protobuf vznikají na drátě, ne v URL. Některé změny polí v gRPC jsou zdarma, jiné potichu rozbijí klienty, a v diffu vypadají stejně.

    Změny API5 min čtení

  • Formáty souborů changelogu: JSON, YAML nebo jen Markdown

    Formát souboru changelogu rozhoduje, jestli může krmit stránku a widget zároveň, nebo ho čte jen člověk. Markdown, JSON a YAML stojí něco jiného.

    Vývoj5 min čtení

  • Duplicitní požadavky: sloučení bez ztráty hlasu

    Seskupování duplicitních požadavků na funkce chrání počet. Neopatrné sloučení ztrácí formulaci, která dělala jeden z nich užitečným, tu menší ztrátu.

    Smyčka zpětné vazby5 min čtení

  • Deprekace GraphQL bez čísla verze

    GraphQL nemá v1 nebo v2 v URL. Pole se deprekují jedno po druhém direktivou, na schématu sdíleném všemi klienty, což mění, co dluží changelog.

    Změny API5 min čtení

  • Jak napsat migrační průvodce API

    Migrační průvodce API mění nekompatibilní změnu ve checklist místo výpadku. Co potřebuje, kdy ho zveřejnit, a proč samotný záznam changelogu nestačí.

    Změny API4 min čtení

  • Záznam changelogu povinně v GitHub Actions: workflow

    Kontrola changelogu v GitHub Actions odmítne merge bez záznamu, protože krok závislý na paměti selhává podle vzorce. Jak ji nastavit a co rozbíjí.

    Vývoj5 min čtení

  • Jak odmítnout požadavek, aniž přijdete o klientku

    Uzavření smyčky obvykle znamená říct někomu, že jeho požadavek úspěšně vyšel. Těžší polovina je říct ne, aniž by se tím poškodil vztah s klientkou.

    Smyčka zpětné vazby4 min čtení

  • Release notes k feature flagu: co napsat a kdy

    Release notes k feature flagu musí rozlišit sloučení a vydání, s flagem to není totéž. Předčasné uzavření smyčky oznámí funkci, kterou žadatel nevidí.

    Smyčka zpětné vazby5 min čtení

  • Požadavek na funkci vs. hlášení chyby: jak je rozeznat

    Tiket podpory žádající o nové nastavení může být obchvat skryté chyby. Špatný štítek ho pošle ke špatné vlastnici a rovnou do špatné fronty.

    Smyčka zpětné vazby4 min čtení

  • Tickety Podpory vs. Požadavky Na Funkce: Čemu Věřit?

    Ticket podpory a nástěnka požadavků na funkce měří odlišné věci, a zacházení s nárůstem u jednoho jako u druhého dává sebejisté, chybné priority.

    Smyčka zpětné vazby4 min čtení

  • Jak sledovat požadavky na funkce, aniž byste je ztratili

    Sledování požadavků na funkce selhává dvěma způsoby: požadavky nikam nedorazí, nebo tam, kam se nikdo nevrací. Jak postavit systém, který obstojí.

    Smyčka zpětné vazby5 min čtení

  • Git tagy vs. GitHub releases vs. changelog

    Git tag, release a záznam changelogu jsou tři záznamy jedné události. Jejich zaměňování nechává changelog odchýlit se. Jak by si tyto tři měly odpovídat.

    Vývoj5 min čtení

  • Interní release notes: kdo další musí vědět, co vyšlo

    Support a obchod se o uvedení obvykle dozví od zmateného zákazníka. Interní release notes to řeší, v jiné podobě než ty zákaznické, dřív než přijde tiket.

    Poznámky k vydání v praxi5 min čtení

  • Interní API changelogy: co se mění pro druhý tým

    Veřejný API changelog má publikum, které nelze kontaktovat přímo. Interní má publikum o dvě patra dál, a to mění, co mu changelog vlastně dluží.

    Změny API4 min čtení

  • Mobilní release notes: limity App Store a Google Play

    Poznámky v App Store smějí mít 4 000 znaků, v Google Play 500, a obě ukážou jen pár řádků bez odkazů. Co limit usekne a jak useknout záměrně.

    Poznámky k vydání v praxi4 min čtení

  • Changelogy v monorepu: jeden, nebo jeden na balíček?

    Monorepo může mít jeden changelog pro celé repo, nebo jeden na balíček. Špatná volba udělá z každého release čtení buď příliš hlučné, nebo roztříštěné.

    Vývoj5 min čtení

  • Oznámení nové funkce: šablony a jak ho napsat

    Většina oznámení funkcí umírá v kanálu, který nikdo nečte dvakrát. Kde oznamovat, co říct jako první, a jak se dostat k těm, kdo si o to skutečně řekli.

    Poznámky k vydání v praxi5 min čtení

  • Jak prioritizovat požadavky na funkce, které se hromadí

    Sledovaný backlog nechává otevřenou tu těžkou otázku: který požadavek jde první. Rámce, které fungují, kde každý selhává, a co skrývá hrubý počet hlasů.

    Smyčka zpětné vazby5 min čtení

  • Enterprise release notes: co se mění pro jeden účet

    Enterprise release notes pro zákazníka na soukromém buildu musí být kalibrované na jeho instanci. Špatná kalibrace prozradí roadmapu nebo zmate podporu.

    Poznámky k vydání v praxi4 min čtení

  • Semantic versioning a váš changelog: co znamená každý skok

    Semantic versioning říká volající straně, jak moc může bolet release, ještě než přečte slovo z changelogu. Co slibuje každé číslo, a co dluží záznam.

    Vývoj5 min čtení

  • Hlavička API Sunset a kdy ji odeslat

    Hlavička API Sunset říká klientovi, kdy verze přestane odpovídat, na rozdíl od oznámení o deprekaci. Co pokrývá RFC 8594 a co přináší brownout před koncem.

    Změny API4 min čtení

  • Changelogy webhooků: breaking change, o kterou nikdo nežádal

    Změna payloadu webhooku se rozbije potichu, protože ji nemá kdo odmítnout. Co dělá změnu payloadu breaking a jak ji krok za krokem verzovat.

    Změny API5 min čtení

  • Co je changelog? Definice a ukázkový záznam

    Changelog je datovaný záznam toho, co se v produktu změnilo, napsaný pro jeho uživatele. Definice, ukázkový záznam a šablona ke zkopírování.

    Poznámky k vydání v praxi5 min čtení

  • API changelog: co publikovat a kdo to čte

    API changelog čtou lidé, kteří rozhodují, jestli jejich kód bude fungovat i příští měsíc. Co dluží každý záznam jim, kde má být, a jak se dá odebírat.

    Změny API6 min čtení

  • Veřejná changelog stránka: jak ji postavit a udržet

    Changelog stránka se vyplatí, když se na ni lidé vracejí a čtou ji znovu. Kde by měla žít, co potřebuje záznam, feedy a markup, a kam patří widget.

    Vývoj5 min čtení

  • Šablona e-mailu o aktualizaci produktu, kterou lidé čtou

    E-mail o aktualizaci produktu, který se čte, šel někomu, kdo o něj požádal. Šablona, čtyři typy e-mailů, funkční předměty, segmentace a souhlas.

    Poznámky k vydání v praxi5 min čtení

  • Deprekace API: harmonogram, oznámení a hlavičky RFC 9745

    Deprekace je slib s datem. Harmonogram, šablona oznámení, hlavičky odpovědi, a krok, který brání sunsetu stát se incidentem podpory pro celý tým.

    Změny API6 min čtení

  • Nejlepší praktiky verzování API, kvůli volajícím

    Verzujte jen to, co rozbíjí kompatibilitu, umístěte verzi tam, kde ji volající vidí, a starou udržujte funkční do data. Čtyři schémata porovnaná.

    Změny API6 min čtení

  • Co je breaking change? Co se počítá a jak ji vydat

    Breaking change je každá změna, kterou by korektní volající nepřežil. Co se počítá, co ne, jak ji zachytit v CI a jak ji bezpečně vydat svým uživatelům.

    Změny API9 min čtení

  • Uzavření smyčky zpětné vazby ze strany changelogu

    Smyčka zpětné vazby se uzavře, když žadatel ví: vydáno. Smyčka ve čtyřech krocích, kde se trhá, a proč je changelog správné místo k jejímu uzavření.

    Smyčka zpětné vazby7 min čtení

  • Šablona požadavku na funkci, která se stává changelogem

    Požadavek na funkci je užitečný jen tehdy, když ho lze znovu najít při vydání. Šablona, štítky, které ho směrují, a pole, která pak čte changelog.

    Smyčka zpětné vazby6 min čtení

  • Veřejná roadmap z vašeho issue trackeru, tři sloupce

    Veřejná roadmap je slib o budoucnosti. Udržujte ji malou, napájejte ji z issue, která už sledujete, a každou položku posouvejte štítkem na jejím issue.

    Smyčka zpětné vazby5 min čtení

  • Automatizace changelogu: co automatizovat a co ne

    Automatizujte sběr, formátování a zveřejňování. Neautomatizujte výběr ani formulaci. Kde je hranice a co se stane pokaždé, když se ta hranice posune.

    Vývoj6 min čtení

  • Changelog vs release notes: jaký je rozdíl?

    Changelog je průběžný záznam pro toho, kdo něco hledá. Release notes jsou vybraná zpráva pro toho, kdo se rozhoduje, zda ho to zajímá. V čem se liší.

    Poznámky k vydání v praxi5 min čtení

  • Od conventional commits k changelogu

    Conventional commits dělají changelog odvoditelný. Nedělají ho čitelný. Co konvence poskytuje, kde se zastavuje, a jak přemostit tu mezeru mezi nimi.

    Vývoj5 min čtení

  • Jak psát release notes, které lidé skutečně čtou

    «Opravy chyb a vylepšení výkonu» není release note. Otázka, na kterou musí odpovědět každý záznam v release notes, a přepis skutečného příkladu.

    Poznámky k vydání v praxi6 min čtení

  • Keep a Changelog vysvětlen, se šablonou CHANGELOG.md

    Specifikace má jednu stránku a čte se deset minut. Zavádění je místo, kde se týmy odchylují. Co říká, co ponechává otevřené, a kde přesně selhává.

    Vývoj5 min čtení

  • Nejlepší praktiky pro release notes, na kterých záleží

    Většina seznamů nejlepších praktik jsou stylistické rady. Tyto mění chování čtenáře, plus tři populární, které se ukázaly být čistý kult cargo.

    Poznámky k vydání v praxi5 min čtení