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

未关闭 适合新手
#29 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
半天
新手友好度
72/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
markdown, python
领域
documentation

调研方向

从 docs/resources/BUDGETING.md 第 8 行的完整表格开始,并阅读 docs/AGENTS.md 了解交叉链接规则;然后比较 docs/channels/SEA.md、SOCIAL.md 和 DISPLAY.md 中的副本。为每一行确定一个来源和一个基准月份,仅在 BUDGETING 中保留完整表格,并让渠道页面链接到它。使用 python scripts/check-internal-links.py 和 mkdocs build --strict 进行验证;完成意味着没有数字在缺少来源和日期的情况下出现两次。

由索引模型根据 Issue 内容生成。

描述

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

主要语言
Python
星标
2
派生
5
平均合并
2 天 17 小时
30 天内合并 PR
6

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

TMHSDigital/Awesome-Ads 的其他 Issue

查看 TMHSDigital/Awesome-Ads 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。