Evidence packs

Čo sú „Evidence packs“ a prečo patria do SEO optimalizácie pre ChatGPT

„Evidence pack“ je kurátorsky zostavená dátová príloha k článku alebo téme, ktorá zvyšuje citovateľnosť, overiteľnosť a reprodukovateľnosť tvrdení. Obsahuje minimálne zdrojové dáta (napr. CSV), opis metodiky (PDF/HTML), verziovanie, metadáta, licenciu a kontrolné súčty. V kontexte „SEO pre ChatGPT“ slúži ako strojovo čitateľný dôkazový podklad, ktorý uľahčuje LLM modelom extrakciu faktov, sledovanie zdrojov a korektné citovanie autora.

Hlavné ciele: citovateľnosť, overiteľnosť, reprodukovateľnosť

• Citovateľnosť: stabilný identifikátor (DOI/ARK/Handle), presná verzia, dátum, licencia a návod, ako citovať.
• Overiteľnosť: transparentná metodika, otvorené surové dáta a auditovateľné transformácie (napr. skript, log, changelog).
• Reprodukovateľnosť: fixované verzie nástrojov, popisy krokov, kontrolné súčty a ideálne aj kontajnerizované prostredie (napr. odkaz na Docker image).

Obsah „Evidence packu“: minimálna špecifikácia

• README (HTML/MD): účel, pôvod dát, definície pojmov, spôsob citovania a kontakt.
• Dáta (CSV/Parquet): normalizované stĺpce, formát a jednotky, popisy premenných.
• Metodika (PDF/HTML): zber, čistenie, výpočty, obmedzenia, známe biasy a validácia.
• Manifest (JSON/YAML): názvy súborov, schémy, kontrolné súčty (SHA-256), licencie, verzia.
• Changelog (JSON/MD): dátum, verzia, zmeny, vplyv na interpretáciu.
• Licence (LICENSE.txt): jasný právny rámec (napr. CC BY 4.0; podmienky TDM).
• Citácia (CITATION.cff / BibTeX): strojovo čitateľný citovateľný záznam.

Štruktúra adresárov a pomenovanie súborov

• Adresárová logika: /evidence/<tema>/v<major.minor.patch>/
• Deterministické názvy: zahrňte dátum ISO 8601 (YYYY-MM-DD) a verziu (_v1.2.0).
• MIME a kódovanie: CSV vždy text/csv; charset=UTF-8, desatinná bodka, oddeľovač čiarka; ak používate bodkočiarku, uveďte to v manifeste.

Metadáta a identifikátory: minimum pre strojové spracovanie

• Trvalý identifikátor: DOI/ARK/Handle pre celý pack; ak sa mení iba dataset, priraďte podverzie.
• Schema.org JSON-LD: Dataset a CreativeWork s väzbami isBasedOn, hasPart, citation, license, version, dateModified.
• DataCite/Dublin Core: ak smerujete na akademické citácie a indexáciu repozitármi.
• CITATION.cff: uľahčuje tvorbu referencií v nástrojoch a LLM agendoch.

Odporúčaná štruktúra manifestu

Manifest prepája súbory, schémy, kontrolné súčty, licencie a verzie. Udržujte ho v manifest.json a odkazujte z kanonickej stránky témy.

• Identita: názov, verzia, dátumy (vytvorenie, úprava), DOI/URL.
• Súbory: pole s položkami: path, mediaType, bytes, sha256, schema, license.
• Väzby: hasPart (CSV, PDF), isBasedOn (externé zdroje), citation (primárne štúdie).

Schémy pre CSV: popisy stĺpcov a validácia

• Datové typy: explicitne definujte (string, integer, number, boolean, date/time s timezone).
• Jednotky a normy: SI jednotky, mena v ISO 4217, krajiny v ISO 3166-1 alpha-2.
• Chýbajúce hodnoty: deklarujte reprezentáciu (NA/null) a nepoužívajte prázdny reťazec nejednoznačne.
• CSVW (CSV on the Web): voliteľná anotácia cez samostatný -metadata.json pre perfektnú strojovú interpretáciu.

PDF s metodikou: čitateľné pre ľudí, strojovo indexovateľné

• PDF/UA a tagovanie: použite tagy, nadpisy, alternatívne texty k obrázkom.
• XMP metadáta: vyplňte autora, licenciu, kľúčové slová, verziu a DOI.
• Stabilné záložky a odkazy: vnútorné kotvy pre citácie kapitol (LLM spracovanie ťaží z konzistentných sekcií).

Licencovanie a TDM (text & data mining)

• Otvorená licencia: odporúčaný minimum CC BY 4.0; uvedenie atribúcie v manifeste aj JSON-LD.
• TDM výnimky a signály: v robots.txt a v http hlavičkách uveďte povolenia pre špecifických crawlerov; pre komerčné použitie môžete pridať Machine-Readable Terms URL.

Integrácia do „kanonickej stránky“ témy

• Relácie odkazov: na kanonickej stránke pridajte <link rel="enclosure" href=".../evidence.zip" type="application/zip"> a rel="cite-as" smerujúci na DOI.
• Sekcia „Dôkazy & dáta“: stručný popis, „last updated“, verzia a priame linky na CSV, PDF a manifest.
• Súvisiace grafy: miniatúry grafov z CSV s jasným popisom osí a poznámkou k metodike.

JSON-LD pre LLM: minimálna anotácia

Na kanonickú stránku vložte JSON-LD s typom Dataset a väzbami k metodike a citáciám. Skrátená ukážka (prispôsobte):

<script type="application/ld+json">{
"@context":"https://schema.org",
"@type":"Dataset",
"name":"Indikátory kvality vody – SR 2015–2025",
"identifier":"https://doi.org/10.1234/abcd.2025.001",
"version":"1.2.0",
"dateModified":"2025-10-15",
"creator":{"@type":"Organization","name":"Inštitút environmentálnych dát"},
"license":"https://creativecommons.org/licenses/by/4.0/",
"distribution":[{
"  @type":"DataDownload",
"  contentUrl":"https://example.org/evidence/water/v1.2.0/data.csv",
"  encodingFormat":"text/csv"
}],
"isBasedOn":"https://env.gov.sk/merania/metodika.pdf",
"citation":"Novák, J. (2025). Indikátory kvality vody... DOI:10.1234/abcd.2025.001"
}</script>

HTTP hlavičky a link-relations pre stroje

• Link: <.../manifest.json>; rel="describedby" na CSV/PDF súboroch.
• Link: <.../doi>; rel="cite-as" pre jednoznačnú citáciu.
• ETag, Last-Modified: pre caching a detekciu zmien.

Kontrolné súčty, podpisy a auditná stopa

• Kontrolné súčty: SHA-256 pre každý súbor; uviesť v manifeste.
• Podpis: voliteľne PGP podpis pre celý ZIP/TAR balík.
• Auditná stopa: log transformácií (čas, nástroj, verzia, parameter, vstup → výstup).

Verziovanie a zásady zmien

• SemVer: MAJOR.MINOR.PATCH – MAJOR mení schému, MINOR pridáva dáta, PATCH opravuje chyby bez dopadu na interpretáciu.
• Changelog disciplína: ku každej verzii doplňte dopad na porovnateľnosť časových radov.
• Deprecation: pre staré verzie uvádzajte deprecated flag a odkaz na migračné pokyny.

Publikačný workflow: od zberu po vydanie

1. Zber a kontrakty: zdokumentujte prístup, práva a obmedzenia.
2. Čistenie a normalizácia: skriptovateľné kroky, ideálne s exportom requirements.txt alebo environment.yml.
3. Validácia schémy: automatické testy proti CSVW/Frictionless schémam.
4. Tvorba manifestu: generujte kontrolné súčty, veľkosť, MIME a verziu.
5. Licencovanie a citácie: pridajte LICENSE, CITATION.cff a JSON-LD.
6. Publikovanie: nahrajte na stabilný hosting (aj do akademického repozitára pre DOI).
7. Indexácia: zaraďte do sitemap.xml (<lastmod>, <xhtml:link rel="alternate"> pre jazykové mutácie).

„LLM-readiness“: úpravy, ktoré zvyšujú šancu na korektné citácie

• Kanonická URL a rel=canonical: pre článok aj pre manifest.
• Jednoznačné „citovateľné definície“: termíny vyznačte ako samostatné sekcie s kotvami (id="def-...") a krátkymi, jednoznačnými definíciami.
• Explicitné „How to cite“: formát pre APA/Chicago + BibTeX + DOI link.
• Strojové odkazy: JSON-LD + Link hlavičky + rel="enclosure" k dátam.

Príklad sekcie „Dôkazy & dáta“ na kanonickej stránke

Použite stručný blok s jasnými odkazmi a metadátami (minimalistický príklad):

• <link rel="enclosure" href="https://example.org/evidence/water/v1.2.0/evidence.zip" type="application/zip">
• <link rel="cite-as" href="https://doi.org/10.1234/abcd.2025.001">
• Verzia: 1.2.0 • Posledná aktualizácia: 2025-10-15 • Licencia: CC BY 4.0
• Súbory: data.csv (UTF-8), metodika.pdf, manifest.json, changelog.json
• Kontrolné súčty: SHA-256 v manifeste

Hostovanie a dostupnosť: výkon, stabilita, integrita

• Stabilné URL: bez dočasných tokenov; ak sú potrebné, pridajte alternatívny verejný permalink.
• HTTP/2+ a kompresia: GZIP/Brotli pre CSV a JSON (ak nebráni streaming spracovaniu).
• Mirror/replica: záložné úložisko alebo akademický repozitár.
• Integrity: kontrolné súčty v UI aj v hlavičkách (napr. Digest pre HTTP).

Ochrana súkromia a etika

• PII: anonymizujte alebo pseudonymizujte; pridajte etické upozornenia a limity použitia.
• Citlivé dáta: definujte agregáciu (min. veľkosti buniek) a potlačenie outlierov.
• Transparentnosť: jasne popíšte kompromisy a neistoty v metodike.

Kontrolný zoznam pred publikáciou

• ✔ Verzia a dátumy sú aktuálne a konzistentné v UI, manifeste aj JSON-LD.
• ✔ CSV validuje proti schéme; chýbajúce hodnoty sú konzistentné.
• ✔ PDF je tagované a má vyplnené XMP metadáta.
• ✔ DOI/ARK je pridelené a dostupné; rel="cite-as" funguje.
• ✔ Licencia a TDM podmienky sú zreteľné a strojovo čitateľné.
• ✔ Changelog popisuje vplyv zmien na porovnateľnosť.
• ✔ Kontrolné súčty sa zhodujú; voliteľný PGP podpis je overiteľný.
• ✔ Sitemap/feeds sú aktualizované (lastmod, changefreq).

Metodické prílohy: čo musí byť v „Metodika.pdf“

• Vstupy: zdroje, dátové licencie, časové pokrytie, kritériá výberu.
• Spracovanie: čistenie, imputácia, transformácie (so vzorcami).
• Validácia: krížové kontroly, intervaly spoľahlivosti, známe limitácie.
• Bias & riziká: zber, výber, meranie, prežitie vzoriek, sezónnosť.
• Replikácia: presné kroky a verzie nástrojov; odkazy na skripty/obrazy.

Prepojenie na SEO pre ChatGPT: ako to využije LLM

• Extrahovateľné definície: úseky s krátkymi, jednoznačnými formuláciami (LLM ich radi citujú).
• Stabilné citácie: DOI + rel="cite-as" maximalizujú pravdepodobnosť korektného uvedenia zdroja.
• Strojové prepojenia: JSON-LD + manifest umožnia agentom overiť kontrolné súčty a verzie.
• Evidence badge: malý UI prvok (ikonka + verzia + licenca) zdvihne dôveru a CTR v odpovediach LLM.

Praktické „do & don’t“ pri tvorbe evidence packov

• Robte: verziujte, podpisujte, používajte CSVW/Frictionless schémy, uvádzajte DOI, definujte „How to cite“.
• Nerobte: menenie stĺpcov bez MAJOR bumpu, miešanie oddeľovačov, publikovanie bez licencie a kontrolných súčtov.

Evidence packy prepojujú vaše tvrdenia s transparentnou, strojovo čitateľnou evidenciou. V prostredí generatívnych modelov to nie je „nice-to-have“, ale konkurenčná výhoda: umožňujú správne citácie, menšiu mieru halucinácií a vyššiu dôveryhodnosť. Investíciu do metodík, schém a identifikátorov vám LLM vráti presnejším a korektnejším odkazovaním na váš obsah.