Documentación / how to
Agregar una nueva experiencia
Para Jenks: crea una nueva entrada de experiencia, proyecto, comunidad o educación que pase la validación y aparezca en todas partes.
Dónde va el archivo
Una entrada es un archivo Markdown. La carpeta depende de su kind:
| tipo | ruta |
|---|---|
experience |
content/corpus/experiences/<slug>.md |
project |
content/corpus/projects/<slug>.md |
community |
content/corpus/community/<slug>.md |
education |
content/corpus/education/<slug>.md |
El slug está en kebab-case y debe ser igual al nombre del archivo.
Plantilla
---
slug: acme-ai-advisor
kind: experience
title: AI Advisor
org: Acme Pty Ltd
orgUrl: https://acme.example
location: Melbourne
start: 2026-11
end: present
tags: [ai, consulting]
lenses: [ai-transformation-consultant, head-of-ai]
skills: [AI strategy, Governance]
metrics:
- One short, factual key result with a number where known
summary: One sentence that says what Jenks did and why it mattered.
featured: false
proof:
- { type: article, title: "Case study", url: "https://acme.example/case-study" }
---
## Overview
The organisation, the situation and Jenks's mandate.
## What Jenks did
- Concrete actions, one per bullet.
## Achievements
- Results with numbers where they are known.
## Why it matters to employers
Why this experience is relevant to the roles Jenks is targeting.
Reglas de los campos
startesYYYY-MM;endesYYYY-MMopresent. Usaperiod(por ejemplo"2010 — 2011") cuando no se conocen los meses exactos, yapprox: truecuando las fechas son aproximadas.tagsdebe provenir de:it,engineering,ai,devrel,web3,business,marketing,consulting,hospitality,community,creative.lensesdebe provenir de:head-of-ai,ai-transformation-consultant,engineering-manager,solution-architect,system-integrator,support-engineer,ict-specialist,developer-advocate,developer-evangelist,digital-marketer,hospitality.- Los elementos de
proofnecesitan untype(article,video,code,talk,paper,site) y untitle;urldebe serhttp(s). - Los proyectos pueden establecer
timeline: truepara aparecer también en la línea de carrera. - Mantén los títulos de puesto oficiales exactamente como en LinkedIn.
La lista completa está en la referencia del modelo de datos y en
jenks admin schema.
Imágenes
Sube fotos, videoclips o archivos PDF a la biblioteca de medios (pestaña Media de la consola, o
jenks admin media upload <file>), luego referencia la url /media/… devuelta:
image: /media/2026/10/acme-workshop-3f9a1c2b7d.webp
imageAlt: Jenks running an AI workshop at Acme
gallery:
- src: /media/2026/10/acme-team-0c1d2e3f4a.webp
alt: The Acme leadership team at the kick-off
imageAlt es obligatorio siempre que se establezca image, y cada elemento de la galería necesita alt. Se rechaza el guardado si no existe un archivo /media/…. En el editor visual de la consola, eliges estos desde la biblioteca en lugar de escribir urls. Consulta Cargar y usar imágenes y archivos.
Publicar
jenks admin validate content/corpus/experiences/acme-ai-advisor.md acme-ai-advisor.md
jenks admin put content/corpus/experiences/acme-ai-advisor.md acme-ai-advisor.md \
-m "Add Acme AI Advisor" --branch dev
jenks admin deploys
Revisa https://dev.jenksguo.xyz/career/acme-ai-advisor, luego jenks admin promote.
Una vez publicada, la entrada aparece en la página de carrera y en su propia página, en los siete idiomas, en
/llms-full.txt y /experience.json, y en las respuestas del asistente Ask Jenks y las herramientas MCP.
.mdEsta página está traducida con ayuda de IA; los títulos oficiales permanecen en inglés.