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

Ajout du Wiki #104

Merged
merged 2 commits into from
Jan 22, 2025
Merged

Ajout du Wiki #104

merged 2 commits into from
Jan 22, 2025

Conversation

CORAAL
Copy link
Contributor

@CORAAL CORAAL commented Dec 26, 2024

Ce pull-request vise à intégrer au dépôt un wiki hébergé via github pages.

Le Wiki est fonctionnel et est prêt à être utilisé en l'état, je souhaite achever quelques pages supplémentaires pour fournir un point de départ sérieux (ex: Expliquer comment écrire la documentation).

Vous pouvez consulter le wiki ici (temporaire).

Ce qu'il faut savoir :

  • Ce PR inclut l'ajout d'un workflow qui s'occupe de générer le site statique contenant la documentation.
  • La documentation est générée systématiquement et automatiquement, lorsque le répertoire docs est modifié.
  • Il faut environ une minute pour générer la documentation.
  • La documentation est écrite en markdown.
  • Il est possible d'ajouter des layouts particuliers pour modifier l'apparence des pages.
  • Support des "callouts" (légende) pour mettre en avant certaines informations.
    • Notez que les callouts ne sont pas propres au markdown (plus d'info ici)
  • Le flocon intègre un "devShell" pour permettre le test de la documentation en direct.
    • Le devshell est prévu pour fonctionner peu importe l'architecture du développeur, pour ce faire, j'ai du ajouter "flake-utils" dans les inputs.

À faire avant la fusion

  • Modifier la branche surveillée de wiki_initdev ici
  • Corriger les fautes d'orthographe, conjugaison et grammaire.
  • Ajouter à flake.nix un Shell de développement (nix develop) pour permettre de construire localement la documentation (dans le but de la vérifier avant soumission)

À faire après la fusion

  •  Activer le workflow fusionné depuis la page action.

Note

N'hésitez pas à faire vos retours si vous avez des commentaires :)

@CORAAL CORAAL added the documentation Improvements or additions to documentation label Dec 26, 2024
@CORAAL CORAAL added this to the Next Release milestone Dec 26, 2024
@CORAAL CORAAL linked an issue Dec 26, 2024 that may be closed by this pull request
@darkone-linux
Copy link
Member

Tu es à fond 💯

@DavidBrigand
Copy link

Super mais pour la commande mettre à jour manuellement le module GLF
sudo bash /etc/update-glf-config.sh
à la place de
bash /etc/update-glf-config.sh ?

@CORAAL
Copy link
Contributor Author

CORAAL commented Dec 31, 2024

Super mais pour la commande mettre à jour manuellement le module GLF sudo bash /etc/update-glf-config.sh à la place de bash /etc/update-glf-config.sh ?

Bonne remarque, merci beaucoup, c'est corrigé

CORAAL pushed a commit to CORAAL/Nixos-by-GLF that referenced this pull request Jan 1, 2025
@CORAAL CORAAL mentioned this pull request Jan 5, 2025
18 tasks
@CORAAL CORAAL force-pushed the wiki_init branch 2 times, most recently from 28ceaf2 to e0b405b Compare January 22, 2025 14:30
@CORAAL CORAAL marked this pull request as ready for review January 22, 2025 14:35
@CORAAL CORAAL requested a review from vinceff January 22, 2025 14:36
@CORAAL CORAAL merged commit ffecdc9 into Gaming-Linux-FR:dev Jan 22, 2025
@CORAAL CORAAL deleted the wiki_init branch January 22, 2025 15:17
@CORAAL
Copy link
Contributor Author

CORAAL commented Jan 22, 2025

Note : Le wiki a été fusionné pour permettre l'ouverture des contributions, le travail ne fait que commencer 🥳

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
Projects
Status: Done ✅
Development

Successfully merging this pull request may close these issues.

Documentation - F.A.Q
4 participants