Englisches Original: https://argusic.com/subject/mkdocs

mkdocs

Projektdokumentation mit Markdown.

LäuftQuelle: GitHubHomepagePythonBSD-2-ClauseCommit 2862536793b3

Python, Lizenz BSD-2-Clause. Das Projekt beschreibt sich selbst als: documentation, markdown, mkdocs, python und static site generator.

mkdocs läuft. Ein Argusic-Agent hat es in 0,5 Minuten installiert und ist auf 1 Fehler gestoßen und hat jeden davon ohne Hilfe behoben. Das geschah auf einer sauberen Maschine ohne GPU, und die gesamte Sitzung wurde aufgezeichnet.

MkDocs 1.6.1 installed from source, all 725 tests pass, CLI version reports correctly, and a real site build produces index.html with expected content.

Was der Agent auf einer sauberen Maschine erreicht hat, in seinen eigenen Worten. So wird gemessen

Von Argusic jedes Mal auf einer frischen Maschine gemessen. Jede Zahl verlinkt auf ihren Nachweis. Argusic Score 100 von 100 (der Mittelwert der Lauf-Scores dieses Projekts).

Auf einen Blick

Befund
Läuft
Argusic Score
100 / 100
Kosten des verifizierenden Laufs
0,10 USD (gemessen)
aufgezeichnete Läufe
2
zuletzt getestet
Sterne
22.533
Forks
2.660
offene Issues
183
Beobachter
223
Größe
32 MB
erstellt
letzter Push

Projektdaten von GitHub, oben auf dieser Seite verlinkt, aktualisiert . Testdaten von Argusic (CC BY 4.0); jede Zahl verlinkt auf eine Laufseite mit dem vollständigen Log, der Aufzeichnung und deren sha256-Hashes.

Was gemessen wurde

Aus dem Lauf, der diesen Befund entschieden hat. Jede Zeile ist ein aufgezeichneter Wert, keine Schätzung.

Durch jeden Fehlschlag verlorene Zeit beim Testen von mkdocs, aus dem aufgezeichneten Lauf gezeichnet
Jeder Balken ist ein Fehler, den der Agent aufgezeichnet hat, mit der Zeit, die er gekostet hat. Aus diesem Lauf gezeichnet, aus keiner anderen Quelle.

Was schiefging, in den Worten des Agents

Die eigenen Worte des Agents, das Schwerste zuerst, nie zu Ratschlägen umgeschrieben.

  • PathSpec.run_validation passed splitlines() with leading whitespace to GitIgnoreSpec, causing all patterns to silently fail to match1 Minute
Installationszeit
unter einer Minute
Von der kalten Maschine bis zum Ende
8 Minuten
Aufgetretene und behobene Fehler
1 aufgetreten, 1 ohne menschliche Hilfe behoben
Wie das Ergebnis belegt wurde
`/tmp/venv/bin/python -m unittest discover -s mkdocs -p "*tests.py"` exited 0, 725 passed (4 skipped)
Verbrauchte Modell-Tokens
103.819
Genau getesteter Commit
2862536793b3
Container-Image
sha256:cdd920bce783

Was nicht gemessen wurde

Die andere Hälfte, damit Sie genau sehen, wie weit dieser Nachweis reicht. Eine Lücke wird als Lücke angezeigt und nie aufgefüllt.

Maximaler GPU-Speicher
dieser Lauf fand auf einer CPU-Maschine statt, es gab also keine GPU zu messen
Verhalten über einen langen Lauf
jeder Versuch verwendet die kleinsten dokumentierten Einstellungen und ein festes Zeitbudget, daher misst dies, ob es läuft, nicht wie es sich unter Last hält

Das Ende der Aufzeichnung

Die letzten Zeilen der Terminalsitzung, die diesen Befund entschieden hat, genau so, wie sie aufgezeichnet wurden.

Everything is complete. Here's the summary:
**Install**: Created Python venv, installed hatch, then `pip install -e .[i18n]` — MkDocs 1.6.1 bui…
**Error found**: `PathSpec.run_validation` in `mkdocs/config/config_options.py` passed `value.split…
**Fix**: Stripped each line before passing to `from_lines()` — whitespace indentation in YAML/Pytho…
**Verification**: All 725 tests pass. CLI reports version correctly. A real site build (write a mar…
tokens used
103,819
Everything is complete. Here's the summary:
**Install**: Created Python venv, installed hatch, then `pip install -e .[i18n]` — MkDocs 1.6.1 bui…
**Error found**: `PathSpec.run_validation` in `mkdocs/config/config_options.py` passed `value.split…
**Fix**: Stripped each line before passing to `from_lines()` — whitespace indentation in YAML/Pytho…
**Verification**: All 725 tests pass. CLI reports version correctly. A real site build (write a mar…

Gesamte Sitzung abspielen, jeder Befehl von einer sauberen Maschine bis zu diesem Punkt.

So wurde getestet

Ein Agent, ein Container, keine menschliche Hilfe. Er installiert das Projekt so, wie es die eigene Dokumentation beschreibt, führt es aus und behebt, was nicht funktioniert. Alles Folgende wurde so aufgezeichnet, wie es geschah: die Terminalsitzung, das Log und der genaue Commit. Die vollständige Methodik.

Stärken und Grenzen

Gemessene Fakten, keine Meinungen. Wie diese Inhalte entstehen.

Was gut lief

  • Hat auf einer sauberen Maschine einen lauffähigen Zustand erreicht, mit aufgezeichneter Sitzung.
  • In 0,5 Minuten installiert, schneller als der Median der 5 vergleichbaren Projekte, die Argusic gemessen hat.
  • Hat sich von dem einen Fehler erholt, ohne dass ein Mensch eingriff, was zeigt, dass die Fehlschläge gut genug dokumentiert sind, um sie zu lösen.
  • Lief ohne GPU, braucht also keine, um zu starten.
  • Lizenz BSD-2-Clause, laut Angabe des Hosts.
  • 2-mal gemessen, das Ergebnis ist also kein Einzelfall.

Von den 6 Projekten im Bereich documentation, die Argusic installiert und zeitlich gemessen hat, belegte mkdocs Platz 1 bei der Zeit bis zum lauffähigen Zustand, und 5 von 6 erreichten überhaupt einen solchen Zustand.

Wofür es eine vernünftige Wahl ist

  • Zum Ausprobieren auf einem Laptop oder kleinen Server: Es erreichte einen lauffähigen Zustand ohne GPU.
  • Für eine schnelle Evaluierung: Es lief 0,5 Minuten nach dem Klonen.

Ebenfalls getestet, im selben Bereich

Jedes dieser Projekte wurde von Argusic auf einer sauberen Maschine installiert und ausgeführt. Hier erscheint nichts, was nicht getestet wurde.

Laufverlauf

getestet vonVersuchErgebnisScoreKosten USDwann
Argusic Runner2/3Läuft100,000,10
Argusic Runner1/3Läuft100,000,03

Themen (von GitHub)

documentationmarkdownmkdocspythonstatic-site-generator

Badge einbetten

Markdown für die README des Projekts. Es verlinkt hierher zurück; Bedingungen auf der Seite mit den Nutzungsbedingungen.

[![Tested by Argusic](https://argusic.com/badge/mkdocs.svg)](https://argusic.com/subject/mkdocs)

Fragen

Läuft mkdocs?
Ja. mkdocs läuft. Argusic hat es auf einer sauberen Maschine in 1 Minuten installiert und gestartet, ist dabei auf 1 Fehler gestoßen und hat die Sitzung aufgezeichnet.
Wie hat Argusic mkdocs getestet?
Auf einer frischen Einwegmaschine, mit jedem Befehl aufgezeichnet und dem Repository fixiert auf Commit 2862536793b3. 2 Versuche sind aufgezeichnet, und die vollständige Methode steht auf der Seite zur Methodik.
Was hat der Test von mkdocs gekostet?
Der Lauf, der diesen Befund ergab, kostete 0,10 USD: echte Rechen- und Modellkosten, kein Listenpreis pro Million Tokens. Der Betrag ist auf der Seite dieses Laufs aufgezeichnet.
Wie lange dauert die Installation von mkdocs?
0,5 Minuten in dem Lauf, der diesen Befund entschieden hat, von einer sauberen Maschine bis zum lauffähigen Zustand. Das ist ein gemessener Versuch, kein Durchschnitt.
Braucht mkdocs eine GPU?
Nicht zum Starten. Argusic hat auf einer Maschine ohne GPU einen lauffähigen Zustand erreicht.
Was geht bei der Installation von mkdocs schief?
Im aufgezeichneten Lauf ging 1 Sache kaputt, und 1 davon wurden ohne menschliche Hilfe behoben. Jedes davon und die Zeit, die es gekostet hat, ist auf dieser Seite aufgeführt.
Wie schneidet mkdocs im Vergleich zu Alternativen ab?
Von den 6 Projekten im Bereich documentation, die Argusic installiert und zeitlich gemessen hat, belegte mkdocs Platz 1 bei der Zeit bis zum lauffähigen Zustand, und 5 von 6 erreichten überhaupt einen solchen Zustand.
Wo ist der Nachweis für mkdocs?
Alle 2 aufgezeichneten Läufe sind auf dieser Seite, jeweils mit Link auf das vollständige Log und die Terminalaufzeichnung, gespeichert mit einem sha256-Fingerabdruck, damit nichts unbemerkt verändert werden kann.

Discussion