Skip to content

Conversation

@this-is-tobi
Copy link
Member

@this-is-tobi this-is-tobi commented Oct 5, 2024

Quel est le comportement actuel ?

La documentation de la plateforme open source ainsi que la documentation de l'offre de services sont mélangées.

Quel est le nouveau comportement ?

Une image docker est désormais générée pour chaque type de documentation dans l'optique de les héberger sur 2 domaines différents.

Cette PR introduit-elle un breaking change ?

Oui.

Autres informations

Il existe désormais 2 dossiers de documentation :

  • cloud-pi-native pour la documentation liée à l'offre de service.
  • hexaforge pour la documentation liée à la plateforme.

J'ai pour l'instant laissé l'ancien dossier docs pour qu'on puisse piocher dedans les docs existantes et les répartir entre les désormais 2 sites. J'ai déjà commencé à proposer une structure des sites que vous pouvez voir dans :

  • Hexaforge
    • Page d'accueil du site : hexaforge/index.md
    • Sidebar du site : hexaforge/.vitepress/sidebar.json
  • Cloud Pi Native
    • Page d'accueil du site : cloud-pi-native/index.md
    • Sidebar du site : cloud-pi-native/.vitepress/sidebar.json

J'ai aussi commencez à réécrire la CI/CD pour build les 2 images, je finirai plus tard ça n'est pas le plus long / dur.

Pour lancer les sites de doc en mode dev vous pouvez (je vous invite à regarder en détail le package.json pour voirs tous les scripts dispos) :

pnpm install
pnpm run dev

@this-is-tobi this-is-tobi self-assigned this Oct 5, 2024
@this-is-tobi this-is-tobi requested review from Baboulinet-33 and removed request for Baboulinet-33 October 5, 2024 16:47
@this-is-tobi this-is-tobi added enhancement New feature or request documentation Improvements or additions to documentation labels Oct 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants