Procés editorial

Per què publiquem això

El blog de Badges Ninja existeix per ajudar els equips a prendre bones decisions sobre credencials digitals — quina plataforma d’emissió fer servir, quan l’estàndard Open Badges és l’opció adequada, com s’hauria de verificar realment una credencial, i així successivament. Cadascuna d’aquestes decisions té costos reals i implicacions de dependència. Per això ens prenem seriosament l’exactitud del que publiquem, i creiem que hauries de saber exactament com es fa el contingut d’aquest blog.

Què distingeix el nostre contingut

• Verificat contra el producte. Cada mostra de codi, crida a l’API i xifra de preu es comprova contra la plataforma real de Badges Ninja en el moment de la redacció. Si una afirmació no es pot provar contra producció, no es publica.
• Escrit per operadors, no per gent de màrqueting. La persona que revisa cada article també fa funcionar la plataforma dia a dia, atén els tiquets de suport i llegeix els senyals operatius que emet.
• Les comparacions són honestes. Quan escrivim “Badges Ninja vs. Credly / Accredible / Badgr” citem literalment la seva documentació pública i les seves pàgines de preus. No fem servir “homes de palla”. Si han llançat alguna cosa que nosaltres no, ho diem.
• Assistit per IA, propietat humana. Un humà identificat aprova cada article abans de publicar-lo. La IA ajuda a escalar; el criteri humà és qui dona el vistiplau final.

Com es fa cada article

1. Creació del brief

Cada article parteix d’un senyal real — un patró en els tiquets de suport, un clúster de consultes de Search Console o una pregunta d’integració d’un client. El brief recull el públic, la promesa que fa l’article i la intenció de cerca a la qual s’adreça.

2. Recerca i verificació del producte

Llegim les fonts primàries de qualsevol afirmació: l’especificació Open Badges, la documentació de 1EdTech (abans IMS Global), i els preus i la documentació de l’API actuals de la competència. Cada fragment de codi s’executa contra la plataforma real de Badges Ninja. Si alguna cosa no funciona tal com està documentada, l’obrim com a error de producte abans de publicar l’article.

3. Redacció

La majoria dels esborranys es produeixen amb assistència d’IA sota una instrucció de generació de contingut que porta el brief de l’article, els fets verificats del pas 2 i la nostra guia de veu. Els esborranys arriben al repositori com a fitxer .md amb el frontmatter complet, llestos per a revisió — sense plantilla de màrqueting ni CMS separat.

4. Revisió humana

Un revisor identificat llegeix cada esborrany de cap a cap. La seva feina és detectar:

• Qualsevol afirmació que no estigui recolzada per les fonts primàries o que no es reprodueixi contra el producte real
• Comparacions que exagerin la nostra posició o que representin malament l’oferta actual d’un competidor
• Consells que costarien diners reals al lector si els seguís — càlculs de preus, elecció de pla, camins de migració
• Text que sona a màrqueting en comptes d’enginyeria pràctica

5. Refinament i lectura final

Les observacions del revisor tornen com a revisions, aplicades per la IA sobre l’esborrany original més el feedback específic del revisor. El revisor llegeix llavors la revisió per confirmar que cada observació s’ha resolt — no només reconeguda.

6. Localització

Traduïm cada article llest per publicar a locales addicionals. Cada traducció preserva l’exactitud tècnica de l’original — les mostres de codi no es reescriuen, només es localitza el text. L’article en anglès sempre és canònic; si una variant traduïda discrepa de l’anglès, guanya l’anglès.

7. Publicació i divulgació de la IA

Cada article publicat porta una divulgació visible de contingut IA (al peu de cada publicació) que explica que l’article ha estat assistit per IA i revisat per humans. Aquest és un senyal de contingut útil de Google i una promesa al lector que la procedència del que estàs llegint no s’amaga.

Mantenir el contingut actualitzat

Open Badges i l’ecosistema de credencials en general es mouen ràpid. Els preus canvien. Les API queden obsoletes. Les bones pràctiques evolucionen. Contingut que era exacte quan es va publicar pot ser enganyós un any després.

Executem un rastrejador automatitzat de SEO i actualitat sobre tot el corpus cada setmana. Recull senyals de Search Console, fa una auditoria pàgina a pàgina i identifica publicacions que estan posicionant per a consultes obsoletes o que referencien API en desús. El resultat és una llista de tasques d’edicions concretes — la majoria mecàniques (corregir un preu obsolet, substituir un endpoint en desús), algunes amb criteri humà (si un article necessita una reescriptura substancial o s’ha de retirar).

Cada publicació porta una data d’Actualitzat: al capçal, diferent de la seva data de publicació original, perquè sàpigues com d’actual és realment el contingut que tens davant.

Els nostres principis editorials

L’exactitud del producte per davant de la velocitat

Preferim publicar un article exacte i verificat per setmana que quatre articles que passin per sobre d’un tema. Si una afirmació no es pot sostenir contra el producte real, no es publica. Punt.

Humans identificats ho revisen tot

La revisió editorial de cada article la fa una persona concreta i identificada — mira la signatura de qualsevol publicació. No publiquem de manera anònima ni ens amaguem darrere d’una veu institucional.

La localització respecta la font

Les traduccions preserven els fets tècnics de l’original en anglès. El text, la puntuació i els idiomatismes específics de cada locale s’ajusten; les afirmacions subjacents no.

Les comparacions citen fonts primàries

Cada afirmació sobre un competidor enllaça a la seva pròpia documentació actual o a la seva pàgina de preus. Si l’oferta d’un competidor ha canviat des que en vam escriure, corregim l’article — no deixem comparacions desactualitzades.

La practicitat per davant de l’enginy

Optimitzem segons si l’article ajuda un equip real a prendre una decisió real — no segons com d’enginyós és el plantejament ni com de nou és l’enfocament.

Transparents sobre la IA

Cada article assistit per IA ho indica, al peu, en cada locale, a cada publicació. Sense subterfugis, sense embellir-ho amb màrqueting.

El nostre compromís

Si trobes alguna cosa en aquest blog que sigui factualment incorrecta, desactualitzada o que representi malament el producte d’un competidor, volem saber-ho. Contacta’ns a support@badges.ninja. Corregim els articles obertament — cada edició substancial actualitza la data d’Actualitzat: i preserva un rastre d’auditoria a l’historial de Git.

La confiança és el veritable sentit d’escriure sobre credencials verificables, d’entrada. Ens exigim el mateix nivell a nosaltres mateixos.