Rédiger une page et la proposer en pull request

L'agent écrit une page neuve dans la forme de votre site, l'ajoute à l'index de sa section pour qu'elle ne soit pas orpheline, et vous l'envoie en pull request brouillon. Rien n'est publié sans votre fusion.

Où trouver l'écran

Contenu, dans le menu de gauche d'un projet. Il demande un dépôt GitHub connecté : une page neuve est un fichier ajouté à votre dépôt, et sans dépôt il n'y a nulle part où l'écrire. Voir Connecter GitHub à un projet.

Écrire une page à la main

Deux champs : un sujet et une adresse. L'adresse est suggérée à partir du sujet, et vous la corrigez — la section (/blog, /guides, /ressources) est une décision éditoriale que personne ne peut deviner à votre place.

Ce qui se passe ensuite, dans l'ordre :

1. L'agent lit l'arborescence de votre dépôt et transpose le chemin d'une page sœur — une page existante de la même section. Il n'essaie pas de deviner la convention de votre générateur : il recopie celle que vous utilisez déjà.
2. Il lit cette page sœur et fait écrire la nouvelle dans sa forme : mêmes clés de tête, même langue, mêmes balises. Une page à qui il manquerait une clé que ses sœurs portent est refusée, pas publiée.
3. Il ajoute l'entrée dans l'index de la section, en clonant l'entrée d'une sœur.
4. Il ouvre la pull request en brouillon.

Ce que l'agent vérifie avant d'écrire

Les deux derniers existent parce qu'ils se sont produits : un modèle recopie volontiers le canonical de la page qu'on lui montre, et un build vert ne voit pas une adresse qui ment.

Le lien depuis la section

Une page que rien ne pointe est orpheline, et votre prochain crawl la signalerait. L'agent distingue trois cas, et il vous dit lequel dans le corps de la pull request :

• l'index cite ses pages à la main → l'entrée est ajoutée, clonée sur celle d'une sœur ;
• la liste est engendrée (un gabarit qui parcourt le dossier) → il n'y a rien à ajouter ;
• il ne sait pas (index ambigu, illisible, absent) → la pull request s'ouvre quand même, en disant en toutes lettres que la page n'est liée depuis nulle part.

Le journal des pages proposées, en bas de l'écran, garde cette information : une ligne « à lier à la main » signale une page dont l'entrée reste à poser.

Le mode automatique

Éteint par défaut. Pour l'allumer il faut nommer la section où les pages iront : personne ne relira l'adresse avant la pull request, et /blog contre /guides ne se devine pas.

Une fois allumé, l'agent écrit au plus une page par semaine et par projet, et seulement :

• sur un sujet qu'un de vos concurrents traite et qu'aucune de vos pages ne couvre — voir Analyser les concurrents ;
• si un crawl de votre propre site existe, sans quoi tout sujet paraîtrait non couvert ;
• sur un sujet jamais proposé auparavant, même si vous aviez fermé sa pull request ;
• et seulement s'il sait lier la page. C'est la seule différence avec le mode manuel : ici personne ne lira l'avertissement, donc une page qu'il ne sait pas relier n'est pas écrite du tout.

Un compte dont le forfait a changé peut toujours éteindre le mode, quel que soit son plan.

Ce que ça coûte

Un article vaut une unité, quelle que soit la taille de la page et le nombre de fichiers touchés — l'index modifié au passage n'est pas un second article. Le compteur est séparé de celui des corrections : publier deux pages ne vous prive pas de vos corrections du mois.

Ces plafonds sont volontairement bas. La politique anti-spam de Google vise le contenu produit en masse dont le but premier est le classement, quelle que soit la façon dont il est produit. Un plafond généreux ferait de cette fonction un moyen de nuire au site qu'elle doit servir.

Ce que cette page ne fait pas

• Elle ne publie rien. La pull request reste en brouillon et n'est jamais fusionnée automatiquement, quel que soit le mode du projet — tout le texte vient d'un modèle.
• Elle ne vérifie pas les faits. Chiffres, noms, dates, prix et promesses commerciales sont à contrôler avant de fusionner. Le texte est plausible, il n'est pas vérifié.
• Elle n'écrit pas la première page d'une section. Sans page sœur, la convention de votre site pour cette section n'existe pas encore, et l'agent s'abstient plutôt que d'en inventer une.

Une fois la page fusionnée, vérifier qu'une correction a vraiment fonctionné s'applique à elle comme au reste : c'est le crawl suivant qui dit si elle est bien en ligne, indexable et liée.