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

Aberta Para iniciantes
  • Algo errado?
#29 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
Meio dia
Facilidade para iniciantes
72/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
markdown, python
Domínio
documentation

Direção de pesquisa

Comece pela tabela completa em docs/resources/BUDGETING.md linha 8 e leia docs/AGENTS.md para a regra de links cruzados; depois compare as cópias em docs/channels/SEA.md, SOCIAL.md e DISPLAY.md. Decida uma fonte e um mês de referência por linha, mantenha a tabela completa apenas em BUDGETING e vincule as páginas de canais a ela. Verifique com python scripts/check-internal-links.py e mkdocs build --strict; concluído significa que nenhum número aparece duas vezes sem fonte e data.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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

Linguagem predominante
Python
Estrelas
2
Forks
5
Merge médio
2d 17h
PRs com merge (30d)
6

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de TMHSDigital/Awesome-Ads

Todas as issues de TMHSDigital/Awesome-Ads

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.