Tooling consideration for docs site
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Refactorización
- Claridad
- Necesita aclaración
- Estado de actividad
- Estancado
- Área
- documentation, tooling
Línea de trabajo
No se mencionan archivos del repositorio ni puntos de entrada. Empieza por localizar la configuración actual de dependencias de MkDocs y Material, así como los comandos utilizados para compilar o servir el sitio, y después compara las tres opciones con las indicaciones de migración enlazadas. Se considerará terminado cuando se haya seleccionado y documentado un enfoque, y se haya verificado mediante una compilación exitosa del sitio.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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!
- Lenguaje dominante
- Python
- Estrellas
- 1
- Forks
- 1
- Merge medio
- 6 d 1 h
- PR fusionados (30 d)
- 1
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de Imageomics/Collaborative-distributed-science-guide
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
enhancement good first issue
Dificultad 1/5 Menos de una hora Aptitud para principiantes 72/100
-
enhancement good first issue
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
-
Add footnote hover?Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 48/100
-
Update GH PR Guide PageAbiertodocumentation enhancement
Dificultad 3/5 1-2 días Aptitud para principiantes 65/100
Todos los issues de Imageomics/Collaborative-distributed-science-guide
Issues similares
-
automated endpoint-dead needs-curation
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
almanac-data/climate-almanac#138 ·
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 67/100
OceanDataTools/openrvdas#760 ·
Los mantenedores suelen responder en 1 día
-
level/subtask type/enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
wazuh/wazuh-virtual-machines#1091 ·
Los mantenedores suelen responder en 1 día
-
Python: Bug: ChatMessageContent.from_element drops AudioContent and BinaryContent into raw TextContentPosiblemente ocupada @halcyon-past la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
microsoft/semantic-kernel#14824 · 1 comentario ·
Los mantenedores suelen responder en 3 días
-
help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
stack314/django-neolith#142 · 1 comentario ·
Los mantenedores suelen responder en 1 día