Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Add a new docs section "Building a package"

Offen
  • Stimmt etwas nicht?
#686 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
42/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Veraltet
Tech-Stack
python
Bereich
build-system, documentation

Rechercherichtung

Beginne mit der Durchsicht der Diskussion im pull request 634 und der vorhandenen nicht öffentlichen Erklärung in design-old.rst. Verwende die verlinkte Seite zu den Build-Schritten für Packaging als Kontext und grenze anschließend einen neuen Dokumentationsabschnitt ab, der Build-Isolation, virtuelle Umgebungen, lokale gegenüber weiterverteilbaren Wheels, cibuildwheel, auditwheel und andere relevante Tools behandelt; als abgeschlossen gilt die Aufgabe, wenn diese Themen erklärt und von der Dokumentation aus verlinkt sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

documentation

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.

Vorherrschende Sprache
Python
Sterne
182
Forks
97
Ø Merge
21 Std. 24 Min.
Gemergte PRs (30 T.)
8

Entwicklungsumgebung

Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus mesonbuild/meson-python

Alle Issues in mesonbuild/meson-python

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.