mesonbuild / mesonbuild/meson-python

Add a new docs section "Building a package"

Abierto
#686 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

documentation
Lenguaje dominante
Python
Estrellas
180
Forks
93
Merge medio
2 d 7 h
PR fusionados (30 d)
18

Descripción

From https://github.com/mesonbuild/meson-python/pull/634#issuecomment-2119236087:

@dnicolodi suggested:
I wonder whether it is time to have a Building a package top sections in the documentation with the details about build isolation, venv and some hints about cibuildwheel and co for building redistributable wheels.

@rgommers replied:

Yes, I agree. This is the cause of a lot of the questions/issues we are receiving. I also just searched for auditwheel and it's not in our docs (except in the non-public explanations/design-old.rst).

I won't be able to work on that in the next few days though, since it'll take a few hours at least to do it right. Should we open a new issue for that first, and scope it? I think I'd prefer to address your one comment here, and then have a new PR for the new docs page, containing:

We do indeed get lots of variations of the same questions that are conceptual issues with how Python packaging works and how meson-python fits in. I'm under no illusion that all users are going to understand build isolation and the difference between local and redistributable wheels, but it'd be nice if we could reply with a one-liner linking to the docs.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Empieza revisando la discusión del pull request 634 y la explicación no pública existente en design-old.rst. Usa como contexto la página enlazada sobre los pasos de compilación de packaging y, después, define una nueva sección de documentación que cubra el aislamiento de compilaciones, los entornos virtuales, las wheels locales frente a las redistribuibles, cibuildwheel, auditwheel y otras herramientas relevantes; se considera terminado cuando estos temas estén explicados y enlazados desde la documentación.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
python
Área
build-system, documentation
Tipo de issue
Documentación
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
42/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.