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

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#29 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
Une demi-journée
Accessibilité débutants
72/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
markdown, python
Domaine
documentation

Piste de recherche

Commence par le tableau complet dans docs/resources/BUDGETING.md ligne 8 et lis docs/AGENTS.md pour la règle de liens croisés ; compare ensuite les copies dans docs/channels/SEA.md, SOCIAL.md et DISPLAY.md. Choisis une source et un mois de référence par ligne, conserve le tableau complet uniquement dans BUDGETING et fais pointer les pages de canaux vers lui. Vérifie avec python scripts/check-internal-links.py et mkdocs build --strict ; terminé signifie qu'aucun chiffre n'apparaît deux fois sans source et date.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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

Langage dominant
Python
Étoiles
2
Forks
5
Merge moyen
2 j 17 h
PR mergées (30 j)
6

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de TMHSDigital/Awesome-Ads

Toutes les issues de TMHSDigital/Awesome-Ads

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.