Construire un meilleur workflow pour son portfolio

Un portfolio ne doit pas être une page figée que l'on met à jour seulement quand on a beaucoup de temps. Dans la réalité, les projets évoluent, les expériences changent, les textes deviennent moins précis et certaines réalisations méritent d'être mieux expliquées avec le temps.

Le problème, c'est que beaucoup de portfolios sont construits comme des pages statiques difficiles à maintenir. Pour ajouter un projet, il faut modifier plusieurs composants. Pour publier un article, il faut créer une nouvelle route, ajouter une carte dans une liste, dupliquer des métadonnées et vérifier que tout reste cohérent.

À force, chaque petite mise à jour devient lourde. Le portfolio finit par ne plus refléter le niveau réel de la personne qui l'a construit.

Le vrai problème d'un portfolio

Un portfolio n'est pas seulement une vitrine visuelle. C'est aussi un système de contenu.

Il doit pouvoir répondre à plusieurs besoins :

• présenter des projets récents
• expliquer le contexte d'une réalisation
• montrer une progression dans le temps
• publier des articles ou des notes techniques
• rester simple à modifier sans casser le design
• garder une structure cohérente sur toutes les pages

Quand tout est codé directement dans des composants JSX, le contenu devient mélangé à l'interface. Ce n'est pas toujours un problème au début, mais dès que le portfolio grandit, cela rend les mises à jour moins agréables.

Pourquoi utiliser MDX

MDX apporte un bon équilibre entre écriture et développement. On peut rédiger du contenu comme dans un fichier Markdown classique, tout en gardant la possibilité d'utiliser des composants React quand c'est utile.

Dans un portfolio, c'est particulièrement pratique pour les pages de projets et les articles de blog. Chaque contenu peut vivre dans son propre fichier, avec ses métadonnées et son texte.

Par exemple, un article peut contenir :

• un titre
• une description
• une date de publication
• un temps de lecture
• le contenu principal

L'application peut ensuite lire ces informations automatiquement pour générer la liste des articles, les pages détaillées, les liens SEO et la navigation.

Une structure plus simple à maintenir

Dans mon approche, le contenu vit dans des dossiers dédiés :

• content/blog pour les articles
• content/projects pour les projets
• content/lab pour les expérimentations

Chaque fichier représente une page. Cela permet de travailler plus proprement : quand je veux ajouter un projet, je crée un fichier MDX. Quand je veux améliorer un article, je modifie uniquement son contenu.

Le reste du site se charge de récupérer les données, de trier les éléments par date et d'afficher les pages avec le même design.

Ce workflow évite de répéter la même logique partout. Il réduit aussi le risque d'oublier une carte, une route ou une métadonnée importante.

Ce que cela change concrètement

Avec une bonne organisation, publier devient beaucoup plus simple.

Au lieu de toucher à plusieurs fichiers, le processus ressemble à ceci :

1. créer un nouveau fichier MDX
2. remplir les métadonnées
3. écrire le contenu
4. laisser le site générer la page et l'ajouter à la liste

Ce n'est pas seulement plus rapide. C'est aussi plus fiable, parce que le même système gère tous les contenus de la même manière.

Quand le portfolio est organisé ainsi, on peut passer plus de temps sur la qualité du contenu : mieux expliquer le problème, clarifier son rôle, montrer l'utilité du projet et raconter le résultat de manière compréhensible.

Le contenu doit rester vivant

Un bon portfolio évolue avec la personne qui le porte.

Un projet que l'on a présenté en deux lignes peut devenir une vraie étude de cas. Un article peut être enrichi après une nouvelle expérience. Une page peut être reformulée pour être plus claire, plus professionnelle ou plus adaptée au public visé.

C'est pour cette raison que le workflow compte autant que le design. Si le site est beau mais difficile à mettre à jour, il finira par prendre du retard. Si le contenu est simple à modifier, le portfolio reste vivant.

Ce que je recherche dans ce workflow

Je veux un portfolio qui reste :

• personnel, parce qu'il doit refléter ma manière de penser
• flexible, parce que les projets et les idées changent
• maintenable, parce qu'un bon site doit rester facile à faire évoluer
• cohérent, parce que chaque page doit garder la même qualité de présentation

MDX m'aide à garder cette séparation entre la structure du site et le contenu que je publie. Le code s'occupe du rendu, tandis que les fichiers MDX gardent les textes faciles à lire et à améliorer.

Conclusion

Améliorer un portfolio ne consiste pas seulement à changer les couleurs, les animations ou les cartes de projet. Il faut aussi penser à la manière dont le contenu sera ajouté, corrigé et enrichi dans le temps.

Un bon workflow rend ce travail plus naturel. Il permet de publier plus vite, de rester cohérent et de faire évoluer le portfolio sans devoir reconstruire toute l'interface à chaque changement.

C'est cette logique que je cherche à mettre en place : un portfolio clair pour les visiteurs, mais aussi agréable à maintenir côté créateur.