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í