Je vous ai expliqué que la structure de la base de connaissances respectera le format OKF proposé par Google en juin 2026, en open source. Et que les fichiers sont créés en Markdown.
Tout cela est assez simple, mais comme toujours en informatique — et pas que — la précision doit être parfaite. Un espace en trop, un point-virgule quand il ne faut pas, des guillemets manquants… ce genre de petits détails n’empêchent généralement pas la lecture par un humain, mais perturbe énormément celle de la machine. Un fichier de paramètres ou de code doit donc être parfait. Un simple caractère incorrect ou manquant, et c’est le bug !
Autant donc essayer de produire dès le départ des documents corrects, et donc de les valider au fur et à mesure. Introduisons donc ici le concept de « valideur », un outil qui va lire vos fichiers, vérifier la syntaxe et la grammaire attendues par rapport au standard, et vous signaler vos erreurs.
Une simple recherche Google : https://www.google.com/search?q=OKF+validator pointera vers de nombreux outils. Je ne les ai pas tous testés, mais je suis rapidement tombé sur le site OpenKnowledgeFormat.com qui propose un outil de validation en ligne, gratuit : https://openknowledgeformat.com/validator.
Idéal pour commencer à valider vos fichiers au fur et à mesure de leur création. Rien à installer, tout se fait en ligne, et le rapport généré est parfaitement lisible et compréhensible.
Évidemment l’usage d’un outil de validation Markdown/OKF n’est pas indispensable ! Pas plus que celui d’un correcteur orthographique mais… même les meilleurs sont étonnés de constater le nombre d’erreurs qu’ils ont laissé passer. Je vous recommande donc l’usage d’un de ces outils, d’autant plus qu’ils sont gratuits pour la plupart. Et je vous recommande de l’utiliser dès le début de la création de votre base : rédiger, formater, vérifier, publier. Cela doit devenir un réflexe. Attendre d’avoir plusieurs milliers de documents, rendra leur validation et leur correction épuisantes intellectuellement si vous repoussez la tâche vers la fin.
À votre Markdown, prêt, validez !
PS : l'outil que je vous suggère ici permet de valider individuellement les fichiers Markdown (ce que je suis en train de faire), mais il permettra ensuite de valider l'ensemble du "Bundle OKF", avec ses répertoires, ses liens, etc. Je n'en suis pas là :-)
