Skip to main content
JGJenks Guo

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

  • start es YYYY-MM; end es YYYY-MM o present. Usa period (por ejemplo "2010 — 2011") cuando no se conozcan los meses exactos, y approx: true cuando las fechas sean aproximadas.
  • tags debe venir de: it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative.
  • lenses debe 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 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 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.