Zpět do vitrínkyvitrinka.Co vyšlo · Vydání

Co vyšlo

Posbírané z toho, co se sloučilo.

Každý projekt má jednu průběžnou nástěnku příštího vydání. Sbírá, co se sloučilo ve všech repozitářích, které vydání pokrývá, fakta spočítá server, text napíše AI a jeden dokument s poznámkami odejde v podobě, jakou potřebuje každý jeho čtenář.

01

Jedno okno přes všechny repozitáře

Vydání je okno nad tím, co se sloučilo. V každém repozitáři začíná u commitu, kde skončila jeho část minulého vydání — nikdy u odhadnutého data — takže vydání přes webovou aplikaci, API i mobilní aplikaci se pořád čte jako jedna stránka.

  • Každý navázaný repozitář — nová řada vydání vezme každý repozitář navázaný na projekt, každý na své vlastní větvi. Odkaz na pull request nese název repozitáře, takže se #123 ze dvou repozitářů nikdy nesmíchá.
  • Fakta od serveru, text od AI — pruh statistik, odkazy na pull requesty i nástěnky, kterých se okno dotklo, se počítají z toho, co se opravdu posbíralo; AI píše úvod a položky nové, opravené a vylepšené. Žádný počet nikdy neprojde modelem.
  • Obnovit, pak uzavřít — ↻ refresh projde GitHub a přegeneruje jen vlastní karty AI, nikdy nic, co na nástěnku dal člověk. ✂ cut zmrazí nástěnku jako vydání a otevře další okno tam, kde skončila část každého repozitáře.
Tok vydání v dokumentaci

02

Nejlepší obrazovky, ne ty poslední

Každá položka nese nejvýš jeden screenshot, vybraný z až 24 kandidátů: z obrazovek zachycených uvnitř okna a ze snímků z runnerů a nahrávek na nástěnkách, kterých se okno dotklo. Žádný screenshot se neobjeví dvakrát: snímek, o který stojí dvě položky, dostane ta, pro kterou je jeho nástěnka důkazem.

  • Hodnocený podle pixelů — vizuální skóre se počítá přímo v kódu serveru — bez modelu a bez sítě, takže ho má i instalace bez internetu — a prázdné nebo zašuměné snímky posílá v pořadí dolů; obrazovka, jejíž text vypadá jako chyba, klesne s nimi.
  • Seřazené pro tohle vydání — o pořadí rozhoduje kvalita, souvislost s pull requesty okna a čerstvost a téměř stejné snímky vypadnou — zůstane jeden na každou route a zařízení.
  • Made this sprint — každá položka odkazuje až na tři nástěnky, které za ní stojí, a pod položkami jsou portály až do 24 nástěnek, kterých se okno dotklo, takže důkaz je vždy na jedno kliknutí od řádku, který dokládá.
Co stránka ukazuje, v dokumentaci

03

Jeden dokument, každý čtenář

Kompletní poznámky jsou samostatný dokument a vydání na něj odkazuje: nástěnka ukáže jeho náhled vedle statistik a sekce Release v briefu projektu ho otevře. Jeho rejstřík je dělaný pro vydání — kapitoly, KPI dlaždice, obrazovky v galeriích.

  • Galerie a srovnávací grafy — obrazovky sedí v galerii bento, masonry, carousel nebo grid místo stohu obrázků a číslo, které se pohnulo, se kreslí jako srovnávací graf před a po.
  • Označené podle publika — blok může být psaný pro veřejnost, pro inženýry nebo pro tým. Čtenář si v prohlížeči zvolí Everyone, Public, Technical nebo Internal a bloky psané pro ostatní zmizí.
  • Odejde jako PDF, HTML, e-mail nebo Word — každý export zachová publikum, které si čtenář zvolil, takže zákaznická i týmová verze vzniknou z jednoho zdroje. PDF, e-mail a Word vyrábí server a každý export zapíše do auditního logu.
Dokumenty, publika a exporty v dokumentaci