Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

refactor: split docs between hexaforge and cpin #56

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from

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.

3 participants