Tooling consideration for docs site
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 25/100
- Type d'issue
- Refactorisation
- Clarté
- À clarifier
- Activité
- À l'abandon
- Domaine
- documentation, tooling
Piste de recherche
Aucun fichier du dépôt ni point d’entrée n’est indiqué. Commencez par localiser la configuration actuelle des dépendances de MkDocs et Material, ainsi que les commandes utilisées pour générer ou servir le site, puis comparez les trois options aux indications de migration liées. Le travail sera considéré comme terminé lorsqu’une approche aura été sélectionnée, documentée et vérifiée par une génération réussie du site.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Building/serving a mkdocs site with Material recently yields message:
│ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs
│
│ MkDocs 1.x is unmaintained. We recommend switching to Zensical, our
│ new static site generator, as soon as possible. We're providing an
│ analysis of the situation in this article:
│
│ https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/
The linked summary page in the warning promotes Zensical as their suggested migration/continuity approach.
Presently, it seems like the following options are on the table for consideration among:
- Pin mkdocs and Material dependencies accordingly.
- Migrate to Zensical.
- Adopt mkdocs 2.0 with another theme.
Currently, I believe starting with 1) and phasing to 2) is reasonable for least friction and ideal long-term support. Discussion welcome!
- Langage dominant
- Python
- Étoiles
- 1
- Forks
- 1
- Merge moyen
- 6 j 1 h
- PR mergées (30 j)
- 1
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire 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.
Autres issues de Imageomics/Collaborative-distributed-science-guide
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
-
enhancement good first issue
Difficulté 1/5 Moins d'une heure Accessibilité débutants 72/100
-
enhancement good first issue
Difficulté 1/5 Moins d'une heure Accessibilité débutants 68/100
-
Add footnote hover?Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 48/100
-
Update GH PR Guide PageOuvertedocumentation enhancement
Difficulté 3/5 1-2 jours Accessibilité débutants 65/100
Toutes les issues de Imageomics/Collaborative-distributed-science-guide
Issues similaires
-
automated endpoint-dead needs-curation
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
almanac-data/climate-almanac#138 ·
Les mainteneurs répondent en général sous 1 jour
-
enhancement
Difficulté 2/5 1-3 heures Accessibilité débutants 67/100
OceanDataTools/openrvdas#760 ·
Les mainteneurs répondent en général sous 1 jour
-
level/subtask type/enhancement
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
wazuh/wazuh-virtual-machines#1091 ·
Les mainteneurs répondent en général sous 1 jour
-
Python: Bug: ChatMessageContent.from_element drops AudioContent and BinaryContent into raw TextContentPeut-être pris @halcyon-past l’a pris aujourd’hui. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
microsoft/semantic-kernel#14824 · 1 commentaire ·
Les mainteneurs répondent en général sous 3 jours
-
help wanted
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
stack314/django-neolith#142 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour