Documentación / how to
Agregar una nueva experiencia
Para Jenks — crear 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 conozcan los meses exactos, yapprox: truecuando las fechas sean aproximadas.tagsdebe venir de:it,engineering,ai,devrel,web3,business,marketing,consulting,hospitality,community,creative.lensesdebe venir 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 tiempo de la carrera. - Mantén los títulos de trabajo oficiales exactamente como en LinkedIn.
La lista completa está en la referencia del modelo de datos y en
jenks admin schema.
Imágenes
Agrega una WebP en web/public/img/jenks/ (la carpeta de imágenes no es escribible a través de la API de administración,
por lo que agrega imágenes mediante git). Luego configura:
image: /img/jenks/acme-workshop.webp
imageAlt: Jenks running an AI workshop at Acme
imageAlt es obligatorio siempre que se establezca image, y la compilación fallará si falta el archivo de imagen.
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 publicado, 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.