podman-container-tools/container-libs

Improve man page cross-links

Open

#827 geöffnet am 6. Mai 2026

Auf GitHub ansehen
 (0 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)Go (120 Forks)auto 404
enhancementgood first issue

Repository-Metriken

Stars
 (97 Stars)
PR-Merge-Metriken
 (PR-Metriken ausstehend)

Beschreibung

In our man pages maintained in Markdown, we can show links to other man pages within the project correctly in only one of 1) the GitHub web view, and 2) Linux man pages: if we use real web links in Markdown, they show correctly in GitHub, but md2man turns the link target into an extra text in the page.

Podman has a small pre-processing step to remove the links before running md2man; adopt that and update the man pages.

Contributor Guide

Research-Richtung
Untersuchen Sie das Link Vorverarbeitungsskript von Podman und wenden Sie es auf die Markdown Man Seiten in diesem Repository an. Aktualisieren Sie alle Man Seiten, um das richtige Querverweisformat zu verwenden.
Tech Stack
go
Domain
documentation
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Frisch
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Markdownman pages
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
75