Skip to main content
Jenks Guo

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

  • start es YYYY-MM; end es YYYY-MM o present. Usa period (por ejemplo "2010 — 2011") cuando no se conocen los meses exactos, y approx: true cuando las fechas son aproximadas.
  • tags debe provenir de: it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative.
  • lenses debe 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 proof necesitan un type (article, video, code, talk, paper, site) y un title; url debe ser http(s).
  • Los proyectos pueden establecer timeline: true para 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.