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

Sphinx vs mkdocs?

Offen
#7 0 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
35/100
Issue-Typ
Feature
Klarheit
Muss geklärt werden
Aktivitätsstatus
Ruhig
Tech-Stack
python
Bereich
documentation

Rechercherichtung

Beginne mit dem Lesen der verlinkten aind-software-docs-Standards-Seite, untersuche anschließend die aktuelle Sphinx-Dokumentationskonfiguration dieses Templates und wie deren Standard ausgewählt wird. Vergleiche diese Konfiguration mit der genannten MkDocs-Empfehlung und halte fest, welchem Standard das Template folgen sollte; das Issue ist abgeschlossen, wenn die Entscheidung und die daraus resultierende Ausrichtung des Templates klar dokumentiert sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

aind-software-docs recommends using mkdocs, should the template conform to that instead of defaulting to sphinx docs?

Vorherrschende Sprache
Jinja
Sterne
0
Forks
0
Ø Merge
13 Min.
Gemergte PRs (30 T.)
1

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 AllenNeuralDynamics/python-templates

Alle Issues in AllenNeuralDynamics/python-templates

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

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