Skip to main content
JGJenks Guo

Docs / how to

Ajouter une nouvelle expérience

Pour Jenks — créer une nouvelle entrée d’expérience, de projet, de communauté ou de formation qui passe la validation et apparaît partout.

Où va le fichier

Une entrée correspond à un fichier Markdown. Le dossier dépend de son kind:

type chemin
experience content/corpus/experiences/<slug>.md
project content/corpus/projects/<slug>.md
community content/corpus/community/<slug>.md
education content/corpus/education/<slug>.md

Le slug est en kebab-case et doit être identique au nom du fichier.

Modèle

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

Règles des champs

  • start est au format YYYY-MM ; end est YYYY-MM ou present. Utilisez period (par exemple "2010 — 2011") lorsque les mois exacts ne sont pas connus, et approx: true lorsque les dates sont approximatives.
  • tags doit être choisi parmi : it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative.
  • lenses doit être choisi parmi : head-of-ai, ai-transformation-consultant, engineering-manager, solution-architect, system-integrator, support-engineer, ict-specialist, developer-advocate, developer-evangelist, digital-marketer, hospitality.
  • Les éléments proof nécessitent un type (article, video, code, talk, paper, site) et un title ; url doit être en http(s).
  • Les projets peuvent définir timeline: true pour apparaître également dans la frise chronologique de carrière.
  • Conservez les intitulés de poste officiels exactement comme sur LinkedIn.

La liste complète se trouve dans la data model reference et dans jenks admin schema.

Images

Ajoutez un fichier WebP sous web/public/img/jenks/ (le dossier des images n’est pas accessible en écriture via l’admin API, ajoutez donc les images via git). Puis définissez :

image: /img/jenks/acme-workshop.webp
imageAlt: Jenks running an AI workshop at Acme

imageAlt est requis dès que image est défini, et la compilation échoue si le fichier image est manquant.

Publication

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

Vérifiez https://dev.jenksguo.xyz/career/acme-ai-advisor, puis jenks admin promote.

Une fois publiée, l’entrée apparaît sur la page carrière et sur sa propre page, dans les sept langues, dans /llms-full.txt et /experience.json, et dans les réponses de l’assistant Ask Jenks et des outils MCP.

.mdCette page est traduite avec l’aide de l’IA ; les titres officiels restent en anglais.