mesonbuild / mesonbuild/meson-python
Add a new docs section "Building a package"
Nadie ha tomado este issue todavía.
- 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:
- The content added here
- Content from
design-old.rst - Mentioning all the relevant tools.
- I'd like to refer to https://pypackaging-native.github.io/meta-topics/build_steps_conceptual/#building-and-installing-or-uploading-artifacts, which explains a lot of things that are relevant here.
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
- 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.
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