Redakční proces

Proč to publikujeme

Blog Badges Ninja existuje proto, aby pomáhal týmům dělat správná rozhodnutí ohledně digitálních certifikací — kterou vydávající platformu použít, kdy je standard Open Badges tou správnou volbou, jak by mělo být pověření skutečně ověřováno, a tak dále. Každé z těchto rozhodnutí má reálné náklady a důsledky spojené s uzamčením u dodavatele. Proto bereme přesnost toho, co publikujeme, vážně, a myslíme si, že byste měli přesně vědět, jak obsah na tomto blogu vzniká.

Čím se náš obsah odlišuje

• Ověřeno na produktu. Každá ukázka kódu, volání API a cenový údaj je v době psaní návrhu ověřen oproti reálné platformě Badges Ninja. Pokud tvrzení nelze otestovat oproti produkci, nepublikuje se.
• Píší to lidé, kteří platformu provozují, ne marketéři. Osoba, která každý příspěvek kontroluje, také denně provozuje platformu, řeší tickety podpory a čte provozní signály, které platforma generuje.
• Srovnání jsou poctivá. Když napíšeme „Badges Ninja vs. Credly / Accredible / Badgr“, citujeme doslovně jejich veřejnou dokumentaci a ceníky. Nic není zkresleno v náš prospěch. Pokud konkurence nabízí něco, co my ne, řekneme to.
• S pomocí AI, ale pod lidskou kontrolou. Každý článek před publikací schvaluje konkrétní jmenovaný člověk. AI pomáhá se škálováním; lidský úsudek rozhoduje o zveřejnění.

Jak vzniká každý článek

1. Vytvoření zadání

Každý článek začíná od reálného signálu — vzorce z ticketů podpory, shluku dotazů ze Search Console nebo otázky týkající se zákaznické integrace. Zadání zachycuje cílovou skupinu, slib, který článek dává, a vyhledávací záměr, na který cílí.

2. Výzkum a ověření na produktu

Čteme primární zdroje pro jakékoli tvrzení: specifikaci Open Badges, dokumentaci 1EdTech (dříve IMS Global), aktuální ceníky a dokumentaci API konkurence. Každý úryvek kódu se spouští na reálné platformě Badges Ninja. Pokud něco nefunguje tak, jak je zdokumentováno, nahlásíme to jako chybu produktu ještě před publikací článku.

3. Tvorba návrhu

Většina návrhů vzniká s pomocí AI podle promptu pro generování obsahu, který obsahuje zadání článku, ověřená fakta z kroku 2 a náš stylový průvodce. Návrhy se do repozitáře ukládají jako soubor .md s kompletním frontmatterem, připravené ke kontrole — bez marketingové šablony, bez samostatného CMS.

4. Lidská kontrola

Jmenovaný kontrolor přečte každý návrh od začátku do konce. Jeho úkolem je odhalit:

• jakékoli tvrzení, které není podloženo primárními zdroji nebo se nepodaří zopakovat na reálném produktu
• srovnání, která nadhodnocují naši pozici nebo zkreslují aktuální nabídku konkurence
• rady, které by čtenáře při jejich uplatnění stály reálné peníze — výpočty cen, výběr plánu, migrační postupy
• text, který zní spíš jako marketing než jako praktické inženýrství

5. Zpřesnění a závěrečné čtení

Připomínky kontrolora se vracejí jako úpravy, které provádí AI na základě původního návrhu a konkrétní zpětné vazby kontrolora. Kontrolor poté přečte upravenou verzi, aby potvrdil, že byla vyřešena každá připomínka — nejen vzata na vědomí.

6. Lokalizace

Každý článek připravený k publikaci překládáme do dalších jazykových verzí. Každý překlad zachovává technickou přesnost originálu — ukázky kódu se nepřepisují, lokalizuje se pouze text. Anglická verze článku je vždy závazná; pokud se přeložená verze od anglické liší, platí anglická.

7. Publikace a zveřejnění informace o AI

Každý publikovaný článek obsahuje viditelné upozornění na obsah vytvořený s pomocí AI (na konci každého příspěvku), které vysvětluje, že článek vznikl s pomocí AI a prošel lidskou kontrolou. Jde o signál pro Google v rámci pravidel o užitečném obsahu a zároveň o slib čtenáři, že původ toho, co čte, není skrytý.

Jak udržujeme obsah aktuální

Open Badges a celý ekosystém certifikací se vyvíjí rychle. Ceny se mění. API zastarávají. Osvědčené postupy se vyvíjejí. Obsah, který byl přesný v době publikace, se může za rok stát zavádějícím.

Nad celým obsahem spouštíme každý týden automatizovaný nástroj pro sledování SEO a aktuálnosti. Ten stahuje signály ze Search Console, provádí audit jednotlivých stránek na místě a identifikuje příspěvky, které se umísťují na zastaralé dotazy nebo odkazují na zastaralá API. Výsledkem je seznam konkrétních úprav — většinou mechanických (oprava zastaralé ceny, nahrazení zastaralého endpointu), některé vyžadují lidský úsudek (zda článek potřebuje zásadní přepracování, nebo zda by měl být stažen).

Každý příspěvek má v úvodní části datum Aktualizováno:, odlišné od data původního publikování, takže vždy víte, jak aktuální je obsah, který právě čtete.

Naše redakční principy

Přesnost produktu nadřazena rychlosti

Raději publikujeme jeden přesný, ověřený článek týdně než čtyři články, které téma jen povrchně nastíní. Pokud tvrzení nelze podložit na reálném produktu, nepublikuje se. Tečka.

Vše kontrolují jmenovaní lidé

Redakční kontrolu každého článku provádí konkrétní, jmenovaná osoba — viz autorský podpis u jakéhokoli příspěvku. Nepublikujeme anonymně a neschováváme se za institucionální hlas.

Lokalizace respektuje zdroj

Překlady zachovávají technická fakta anglického originálu. Text, interpunkce a idiomy specifické pro daný jazyk se přizpůsobují; podkladová tvrzení se nemění.

Srovnání citují primární zdroje

Každé tvrzení o konkurenci odkazuje na aktuální dokumentaci nebo ceník dané konkurence. Pokud se nabídka konkurence od doby, kdy jsme o ní psali, změnila, článek opravíme — zastaralá srovnání neponecháváme beze změny.

Praktičnost nad vtipností

Optimalizujeme na to, zda článek pomůže reálnému týmu udělat reálné rozhodnutí — ne na to, jak vtipné je podání nebo jak originální je úhel pohledu.

Transparentnost ohledně AI

Každý článek vytvořený s pomocí AI to uvádí, na konci, v každé jazykové verzi, při každé publikaci. Bez vytáček, bez marketingového balení.

Náš závazek

Pokud na tomto blogu najdete něco, co je fakticky nesprávné, zastaralé nebo zkresluje produkt konkurence, chceme to vědět. Ozvěte se nám na support@badges.ninja. Články opravujeme otevřeně — každá podstatná úprava posune datum Aktualizováno: a zachovává auditní stopu v historii Gitu.

Důvěra je celým smyslem psaní o ověřitelných pověřeních. Sami na sebe klademe stejný standard.