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

Standardisation of sphinx docs page titles

Offen
#232 14 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
25/100
Issue-Typ
Dokumentation
Klarheit
Muss geklärt werden
Aktivitätsstatus
Veraltet

Rechercherichtung

Prüfe zuerst die Beispielseite unter https://diamondlightsource.github.io/python-copier-template/main/how-to.html und die Issue-Diskussion, da keine Quelldatei oder kein Test genannt ist. Bestätige, dass sich das Projekt auf eine Konvention für Titel geeinigt hat, und ermittle den Einstiegspunkt für den Dokumentations-Build, bevor du den Umfang einer Prüfung festlegst; abgeschlossen bedeutet, dass die Konvention eindeutig festgelegt ist und der Build sie konsistent erzwingt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

enhancement

This may be the nitpickiest issue I have ever raised, so should not be actioned unless there's strong agreement.

Image
(from https://diamondlightsource.github.io/python-copier-template/main/how-to.html)

It annoys me that the titles for docs pages are not really standardised, Some Are Capitalised, some are not, some are prefixed with "How to" or similar. If there is a really easy check that can be added to the docs builds it might add a layer of consistency and professionalism. The hardest part, as ever when we talk about formatting, may be agreeing on which standard to use.

Vorherrschende Sprache
Jinja
Sterne
25
Forks
10
Ø Merge
4 T. 17 Std.
Gemergte PRs (30 T.)
7

Beitragsleitfaden

Beitragsleitfaden öffnen

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 DiamondLightSource/python-copier-template

Alle Issues in DiamondLightSource/python-copier-template

Ähnliche Issues

Weitere Issues zu Build System

Neue Issues direkt in Ihr Postfach

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