Cost benchmark tables are copied across four guides with no source or date

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#29 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
Ein halber Tag
Anfängerfreundlichkeit
72/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
markdown, python
Bereich
documentation

Rechercherichtung

Beginne mit der vollständigen Tabelle in docs/resources/BUDGETING.md Zeile 8 und lies docs/AGENTS.md für die Cross-Link-Regel; vergleiche dann die Kopien in docs/channels/SEA.md, SOCIAL.md und DISPLAY.md. Entscheide dich pro Zeile für eine Quelle und einen Stand-Monat, behalte die vollständige Tabelle nur in BUDGETING und verlinke die Kanal-Seiten darauf. Prüfe mit python scripts/check-internal-links.py und mkdocs build --strict; fertig bedeutet, dass keine Zahl zweimal ohne Quelle und Datum erscheint.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

documentation help wanted severity: low

Summary

The 2026 cost benchmark figures are copied into four separate tables, with no as-of month or source per figure. When a number is updated in one place, the others will drift.

Where

  • docs/resources/BUDGETING.md:8 (full table)
  • docs/channels/SEA.md:34
  • docs/channels/SOCIAL.md:6
  • docs/channels/DISPLAY.md:37

Details

The same values appear in several tables, for example Google Search ~$5.42 CPC (BUDGETING, SEA), Google Display Network ~$0.63 (BUDGETING, SEA, DISPLAY), Facebook $1.72 CPC / $14.68 CPM (BUDGETING, SOCIAL), LinkedIn $5.58 / $26.91 (BUDGETING, SOCIAL). docs/AGENTS.md asks contributors not to duplicate large blocks and to cross-link instead.

None of the rows say where the figure comes from or which month it was measured, and ad prices move quickly.

Impact

Readers use these numbers to set budgets. Figures that disagree between pages, or that are a year old with no date, will mislead them.

Suggested fix

  1. Keep one table in docs/resources/BUDGETING.md. Add an "As of" month and a source link for each row (or a footnote per source).
  2. On SEA, SOCIAL, and DISPLAY, keep only the rows for that channel with a link to the Budgeting table as the source of truth, or replace the table with a link.

Acceptance criteria

  • Each benchmark figure appears in one place, or channel pages state that BUDGETING is the source.
  • Each row has a source and an as-of date.

Getting started

  • Relevant files: the four listed above
  • How to check: python scripts/check-internal-links.py, mkdocs build --strict

Filed by repo-audit/full-audit at 79cb5dc. Severity: low. Effort: M. audit-key: documentation|docs/resources/BUDGETING.md|cost-benchmarks

Vorherrschende Sprache
Python
Sterne
2
Forks
5
Ø Merge
2 T. 17 Std.
Gemergte PRs (30 T.)
6

Entwicklungsumgebung

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 TMHSDigital/Awesome-Ads

Alle Issues in TMHSDigital/Awesome-Ads

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

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