[mkdocs] - rebuild docs automatically on update
Personne n'a encore pris cette issue.
- Langage dominant
- JavaScript
- Étoiles
- 18.3k
- Forks
- 2k
- Merge moyen
- 2 j 12 h
- PR mergées (30 j)
- 28
Description
One of the benefits of our current docs for contributors if you are working on a doc and make some change to an example or some text, jekyll rebuilds the documentation automatically and you can see the change in your browser.
With how mkdocs is implemented on the live-docs branch you need to stop the mkdocs server, rebuild the docs using make examples and then restart the server (mkdocs serve)
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez sur la branche live-docs en examinant comment make examples et mkdocs serve sont actuellement utilisés. Suivez le flux de reconstruction de la documentation et comparez-le au comportement de Jekyll décrit ; le travail est terminé lorsque les modifications apportées aux exemples ou au texte apparaissent dans le navigateur sans devoir arrêter, reconstruire et redémarrer manuellement le serveur.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Domaine
- build-system, documentation
- Type d'issue
- Fonctionnalité
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 35/100