AI-írt PR-részletek elrejtése <details><summary> elemmel a gyorsabb átolvasásért

A szerző szerint a legtöbb változtatás ma PR‑ek (pull requestek) formájában érkezik, amelyeket gyakran Claude Code vagy Codex nyit meg számára. A PR a munkafolyamat egysége: commitokat csomagolnak össze, iterálnak rajtuk, dokumentálják a döntéseket, majd mergelik az elkészült megoldást. A jelenlegi kódszerző ügynökök kiválóak a PR‑leírások megírásában, de éppen ez a probléma forrása: túl részletesek és hosszúak ahhoz, hogy gyorsan áttekinthessük őket.

Az agent‑írt leírások pontosak és átfogóak — leírják a problémát, a megoldást és a verifikáció lépéseit. Ennek ellenére olvasásuk gyakran terhes: a hosszú, gép által előállított szöveg elriaszthatja a reviewer‑t, aki inkább egy rövid, emberi ítéleten alapuló bevezetőt szeretne, ami magas szinten elmagyarázza, miről szól a PR és érdemes‑e további figyelmet fordítani rá.

A javasolt megoldás: rejtés <details><summary> elemmel

A szerző egyszerű, alacsony ráfordítású megoldást talált: a hosszú, ügynök által előállított részek elrejtését HTML <details><summary> tagjeivel. A <details><summary> elemek összecsukható fejlécet biztosítanak — a summary látszik, a részletek csak kibontva jelennek meg. Fontos, hogy a GitHub Markdown támogatja ezt a kombinációt, így ez a trükk közvetlenül működik PR‑leírásokban és issue‑kban.

A szerző munkafolyamata:

• A PR nyitó bekezdése gondosan kiválasztott, emberi szerkesztésű, rövid összefoglaló, amely magas szinten elmagyarázza, mit tesz a PR és miért fontos. Gyakran képernyőképet is csatol, mert a képek gyorsan szemléltetik az új funkciót.
• Az ügynök által írt hosszabb, részletező esszé ezután következik egy <details><summary> blokkban. A summary mezőben a modell neve és gyakran a „munka­erőfeszítés” szintje szerepel (például "Claude Opus 5.5 Medium"), hogy egyértelmű legyen, mi az, és mennyi automatikus munkát jelent.

Ennek hatása: a PR‑ek nem tűnnek annyira „összefolyt” vagy túlzsúfolt szövegnek. Az összes információ megmarad, de az olvasó első pillantásra megkapja a rövid, emberi jóváhagyású bevezetőt, anélkül, hogy rögtön több bekezdésnyi automatikus szövegbe merülne.

Példák a gyakorlatból

A szerző több közelmúltbeli PR‑ben alkalmazta ezt a mintát, és megadja a PR‑nyitók szövegét is:

• datasette PR #3052: Redesign row page as a vertical list of fields

  • "The row page showed its single row as a one-row table. For wide tables, like a 46-column GitHub repos table, that scrolled far off to the right and left most of the page blank." (majd képernyőkép)

• datasette PR #3043: Pagination bar showing which rows are on the current page

  • "Table pages that span more than one page now make it obvious where you are, and offer navigation at the top of the page as well as the bottom." (plus screenshot)

• datasette PR #3042: Load edit-tools.js on demand via a small loader

  • "edit-tools.js (~220KB) was loaded on every table, row and database page, even for users who couldn't edit anything. Now only load it for users who can edit when they first interact with an edit feature (including mouse over an edit link)."

• datasette-agent PR #51: register_agent_reference_types plugin hook

  • "Lets plugins add their own kinds of item to the # tagging in the chat composer using a new register_agent_reference_types(datasette) plugin hook."

• llm PR #1838: Add llm openai endpoint add/list/remove/path commands

  • "Adds commands for managing the records in extra-openai-models.yaml, so OpenAI-compatible endpoints can be saved from the command line instead of by hand-editing YAML." (majd a --help output másolata)

Ezekben a példákban a rövid emberi bevezetők célja, hogy egy pillantással megadhassák a fontos információt, míg a részletes, modell‑generált tartalom továbbra is elérhető a kibontott <details> alatt.

Tippek a címke­rendezés megjegyzéséhez

A szerző megoszt két emlékeztetőt a HTML tagek sorrendjének felidézéséhez:

1. A <summary> az összegző rész, amit kattintva kibővítesz — ezért a <details> tagnak kell a környező elemnek lennie.
2. Használja a „details-summary” mnemonikát (két szótag, majd három szótag), mert ez könnyebben kiejthető és segít emlékezni a helyes sorrendre.

Megjegyzésként a szerző még szeretné, ha a GitHub Markdown szerkesztője gombot adna ehhez a funkcióhoz, hogy mobilon és szélesebb felhasználói réteg számára is könnyebben elérhető legyen.

Összefoglalás

A GitHub‑on működő <details><summary> használata egyszerű és hatékony eszköz arra, hogy a modell‑generált PR‑leírások részleteit elrejtsük, miközben egy rövid, emberi szerkesztésű bevezetőt helyezünk el a tetején. Így a PR‑ek átláthatóbbak lesznek, a fontos, ember által jóváhagyott információ gyorsan hozzáférhető, és a teljes részletesség szükség esetén továbbra is elérhető marad.