Skip to main content
Jenks Guo

Docs / how to

Add a new experience

For Jenks — create a new experience, project, community or education entry that passes validation and appears everywhere.

Where the file goes

One entry is one Markdown file. The folder depends on its kind:

kind path
experience content/corpus/experiences/<slug>.md
project content/corpus/projects/<slug>.md
community content/corpus/community/<slug>.md
education content/corpus/education/<slug>.md

The slug is kebab-case and must equal the file name.

Template

---
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.

Field rules

  • start is YYYY-MM; end is YYYY-MM or present. Use period (for example "2010 — 2011") when exact months are not known, and approx: true when dates are approximate.
  • tags must come from: it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative.
  • lenses must come from: head-of-ai, ai-transformation-consultant, engineering-manager, solution-architect, system-integrator, support-engineer, ict-specialist, developer-advocate, developer-evangelist, digital-marketer, hospitality.
  • proof items need a type (article, video, code, talk, paper, site) and a title; url must be http(s).
  • Projects can set timeline: true to appear in the career timeline too.
  • Keep official job titles exactly as on LinkedIn.

The full list is in the data model reference and in jenks admin schema.

Images

Upload photos, video clips or PDFs to the media library (console Media tab, or jenks admin media upload <file>), then reference the returned /media/… url:

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 is required whenever image is set, and every gallery item needs alt. Saving is refused if a /media/… file does not exist. In the console's visual editor you pick these from the library instead of typing urls. See Upload and use images and files.

Publish

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

Check https://dev.jenksguo.xyz/career/acme-ai-advisor, then jenks admin promote.

Once published, the entry appears on the career page and its own page, in all seven languages, in /llms-full.txt and /experience.json, and in the answers of the Ask Jenks assistant and the MCP tools.

.md