plotly / plotly/plotly.py

[mkdocs] Add github action that tests the build of the example pages

Offen
#5,402 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

bug P1
Vorherrschende Sprache
Python
Sterne
18.8k
Forks
2.8k
Ø Merge
16 Std. 26 Min.
Gemergte PRs (30 T.)
21

Beschreibung

Right now we build the examples from jupyter notebooks here
https://github.com/plotly/plotly.py/blob/main/.circleci/config.yml#L356-L388

If any notebook outputs an error the build fails and the docs won't publish

We need to implement something similar for the new docs so we don't end up showing failures on published pages

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne damit, die Notebook-Build-Schritte in .circleci/config.yml in den Zeilen 356-388 zu lesen und sie mit dem neuen MkDocs-Beispielseiten-Build zu vergleichen. Definiere den GitHub Actions-Check so, dass Fehler in der Notebook-Ausgabe den Build vor der Veröffentlichung der Dokumentation fehlschlagen lassen; abgeschlossen ist es, wenn der Workflow diese Fehler erkennt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
github-actions, jupyter-notebook, python
Bereich
build-system, ci-cd, documentation
Issue-Typ
Feature
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
42/100

Neue Issues direkt in Ihr Postfach

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