Guide d’utilisation
Utiliser ce site comme système de publication pour la doc EmDash, le contenu de migration, les plugins, les modèles et les mises à jour produit.
Rôle de ce site web
emdashcmseverything.com ne doit pas se comporter comme une page d’atterrissage générique. Il doit servir de couche publique de connaissance et de distribution pour l’écosystème EmDash.
Cela implique de combiner plusieurs missions de contenu dans un système cohérent :
- expliquer ce qu’est EmDash
- montrer comment ça fonctionne
- indiquer où ça s’insère
- publier plugins et modèles
- guider les migrations WordPress
- annoncer l’avancement produit et les sorties
Architecture de l’information recommandée
La structure actuelle est pensée pour ce modèle :
docs/docspour la documentation pérennedocs/use-casespour le contenu d’adoption par scénariosdocs/pluginspour les fiches du répertoire de pluginsdocs/templatespour les fiches du répertoire de modèlesdocs/faqpour les mises à jour, tutoriels et contenu éditorial
C’est plus adapté que de tout entasser sur une page marketing unique ou de cacher l’information produit dans des composants de framework.
Comment utiliser chaque section
Docs
Utilisez cette section pour du contenu durable et à forte intention :
- prise en main
- explications de fonctionnalités
- notes de déploiement
- vues d’ensemble d’architecture
- FAQ
Ces pages doivent répondre aux questions posées avant et pendant l’évaluation.
Cas d’usage
Utilisez cette section pour traduire les capacités produit en contexte d’achat. EmDash est plus facile à comprendre lorsqu’on le présente comme adapté à :
- la publication éditoriale
- la documentation et les bases de connaissances
- les écosystèmes de plugins
- les activités autour de modèles
Cette section doit relier la forme du produit à des résultats concrets.
Plugins
Les pages plugin doivent ressembler à de petites pages produit, pas seulement à des notes de version. Chacune doit expliquer :
- ce que fait le plugin
- à qui il s’adresse
- l’état actuel
- le prix ou la disponibilité
- le chemin de téléchargement
- la configuration et la compatibilité
Modèles
Les pages modèle doivent faciliter la comparaison des starters packagés. De bonnes entrées incluent :
- public cible
- captures d’écran
- détails de la stack
- version et date de sortie
- lien de démo
- lien de téléchargement ou dépôt
Blog et mises à jour
Cette section doit refléter l’activité :
- notes de version
- guides de migration
- commentaires produit
- tutoriels
- études de cas
C’est ce qui donne l’impression d’un site vivant et qui s’enrichit.
Flux de publication
Pour ce projet, le flux le plus simple et sain est :
- Ajouter ou réviser le contenu dans
docs/ - Relire le diff Git
- Prévisualiser en local
- Déployer le site statique construit sur Cloudflare Pages
Ce flux est particulièrement efficace lorsque l’IA aide à la rédaction, l’édition, la restructuration et la cohérence.
Pourquoi cette structure fonctionne bien avec l’IA
L’édition assistée par IA est bien plus fiable lorsque le site repose sur :
- de petits fichiers MDX
- un frontmatter explicite
- des composants de page réutilisables
- des motifs de routes stables
- un contenu séparé du code UI
C’est pourquoi la forme actuelle du site est volontairement centrée sur le contenu.
Lien avec EmDash lui-même
Les supports officiels EmDash mettent l’accent sur les collections runtime, l’admin d’édition, les plugins, le stockage média et la portabilité cloud. Ce sont des atouts produit. Mais un site écosystème public n’a pas besoin de tout cela immédiatement.
Le site statique est la couche de présentation publique.
Le runtime EmDash complet est la couche suivante lorsque vous avez besoin de :
- rédacteurs non techniques dans le navigateur
- flux de contributeurs authentifiés
- média géré au runtime
- automatisation plus riche ou flux de soumission de plugins
Règle éditoriale simple
Chaque page doit répondre clairement à l’une de ces questions :
- Qu’est-ce qu’EmDash ?
- Pourquoi pas WordPress ?
- Que fait ce plugin ou ce modèle ?
- Comment migrer ?
- Comment déployer ?
- Pourquoi adopter maintenant ?
Si une page n’y répond pas correctement, elle a probablement besoin d’un périmètre plus serré.