PUBLIER UNE DOC en moins d'une heure (avec GITLAB PAGES et DOCUSAURUS) !

[@cyraile]

Je ne compte même plus les cordes de mon arcs... à chaque nouvelle vidéos c'est un nouvel outil. Merci pour le partage et la découverte.

[@yoandevco]

Ha ha ! Ici, c'est pas un arc, mais une harpe 😅

[@thierryengelen3322]

Merrci Yoan, ta video est claire et permet un démarrage rapide avec l'outils. Tu as gagné un abonné 😃

[@thisweekinreact]

Merci pour la pub Yoann ;)

[@yoandevco]

Avec plaisir ! Et merci pour ce super outil !

[@nicoeclektic]

Merci pour le tuto ! C'est simple et rapide, j'adore !

[@Formypips]

Salut Yoann, merci pour la découverte de l’outil et la bonne présentation ! Concernant l’installation des packages node, il est vraiment préférable d’utiliser du cache au niveau de gitlabci entre les pipelines et entre les jobs pour éviter de re-télécharger des centaines de packages à chaque commit. Les pipeline seront également plus rapide. Bonne continuation

[@yoandevco]

Merci pour ton message ! Tout a fait d'accord pour le cache dans la CI, et dans un cas réel c'est exactement ce que je ferai 👌 Mais en mode "démo", je ne veux pas surcharger de trop d'informations pour que ça reste facilement digeste.

[@thisweekinreact]

@@yoandevco on l'a pas encore documenté mais il y a également un cache Docusaurus (webpack 5) a mettre en place pour améliorer les temps de rebuild entre les runs CI (en gros cacher node_modules/.cache/webpack

[@yoandevco]

@@thisweekinreact Top, je vais mettre ça en place sur un projet du boulot ! Merci :)

[@pascalcanadas3670]

Merci pour la découverte

[@yoandevco]

Avec plaisir !

[@pascalcanadas3670]

@@yoandevco je connaissais un peu avec ton projet symfony pour les nuls:)

[@pascalcanadas3670]

@@yoandevco par contre comment s'appelle ton extension gît icon?

[@mathieuregnier2262]

merci tjrs au top !

[@yoandevco]

Merci à toi !

[@mathieuregnier2262]

@@yoandevco de rien

[@webdev723]

Merci yoan sur cette video. Remarque: J'ai utilisé la vitesse 1.5.

[@yoandevco]

Avec plaisir ! Moi aussi je consulte pas mal de vidéos en 1,5 😅

[@pierrevedel1034]

bonjour yoan, merci pour ce tuto que j'applique directement pour creer ma documentation. j'ai plusieurs questions : - est ce qu'on peut retirer l'etape 'test' du yml au bout d'un moment ? - quel est l'interet de creer une branche 'page' et de ne pas tout faire sur le 'master' ? - dans la continuité de cette derniere question, les modifications de la documentation doivent etre faites sur 'master' puis merge ou directement dans 'page' ?

[@olivierlejeune1950]

Merci Yoan comme toujours pour tes vidéos intéressantes et celle ci peut permettre de tout centraliser sur le même gitlab (quand la doc est une doc équipe d’un autre projet lui même déployé sur le gitlab). Juste un peu déçu que tu n’aies pas eu le temps de montrer la modif de la doc en direct sur le site avec auto création d’une merge request si j’ai bien compris ce que tu expliquais. Question : existe il un moyen d’inclure ce docusaurus directement dans un projet symfony ? Ça serait cool que le fichier readme de notre projet symfony contienne juste l’url du projet docusaurus qui se déployerait en parallèle sur le même pipeline et serveur

[@sylvain351]

dommage que ca ne semble pas gerer les graph de type mermaid js comme mdbook, mais ca peut etre sympa. merci

[@yoandevco]

A priori, il existe un plugin (pas testé).

[@sylvain351]

@@yoandevco j'ai un petit soucis [ERROR] Unable to build website for locale en. [ERROR] Error: docusaurus_tag meta tag not found. This is a bug and should never happen.

[@thisweekinreact]

@@sylvain351 est ce que tu peux reporter ce probleme directement sur notre repo GitHub stp?

[@thisweekinreact]

@@yoandevco oui et Mermaid est inclus dans GitHub Flavored Markdown maintenant, alors c'est fort possible qu'on active Mermaid par défaut dans Docusaurus prochainement

[@laurentquetier5100]

Trop déçu 😞 ou presque 😋 En première lecture du titre, j'avais compris "générer une documentation" au lieu de "publier". Très intéressant, toutefois, malgré les temps de pipeline 😱😱 (spoil alert, je suis dev php aussi 😇)

[@yoandevco]

Ha ha 🤣