DEV Community 通过信息流、标签、搜索和作者主页分发开发者文章,适合用教程、工程复盘或
打开 DEV Community 首页,开发者会从 Relevant、Latest、Top、标签页、搜索和作者主页进入文章。他们通常在找一段可以运行的代码、一个故障的解释,或者别人刚做出的开发工具。产品在这里以文章出现,不会自动获得一张新品卡片。
API、SDK、开源项目、命令行工具、测试和部署服务最容易找到读者。面向普通消费者、无法讲清技术或制作过程的产品不太匹配。DEV 的主要内容与界面使用英文。希望核心读者直接理解时,本站建议准备自然、准确的英文稿。
免费文章、免费 Organization 和付费 Showcase 是三条路径
个人账号可以免费发布文章。如果目的是展示刚做出的项目,可以使用 #showdev(在新标签页打开)。这个标签的官方说明是“Show off what you've built!”。近期文章既有短项目介绍,也有架构拆解、版本变化和开发过程。正文至少要说明做了什么、谁会用、怎样体验,以及当前还有哪些限制。
若产品需要一段接入过程才能体现价值,写教程更合适。读者应当在不购买产品的情况下,也能调用一次 API 并得到结果、安装一个组件、复现一类故障或理解一项工程取舍。标签可以选择 tutorial、语言、框架和实际场景,不必同时加 showdev。
团队准备长期发布内容时,可以建立免费的 Organization(在新标签页打开)。设置 Organization 前需要先有个人 DEV 账号。个人作者仍用自己的账号写作,再把文章归到组织名下。组织页面可以集中团队文章、成员、品牌信息和文章旁的行动按钮。
DEV Showcase(在新标签页打开) 是付费合作伙伴目录。Advertise on DEV(在新标签页打开) 将这类曝光放在原生广告与产品推广方案中,需要联系站方合作。它与免费文章、#showdev 标签和免费 Organization 不是同一条路径,也不是公开自助投稿入口。
文章先回答一个开发者会遇到的问题
一篇教程可以从安装、初始化、鉴权、错误处理或部署开始。一次项目展示可以解释为什么制作、核心流程怎样工作、采用了什么技术,以及哪部分仍然不稳定。工程复盘则要写清环境、版本、原做法、故障和修正结果。
命令、依赖、版本和运行环境应当完整。测试数据要说明条件,引用文档、代码、图片或他人观点时链接原始来源。使用自己的产品作为示例时,在文章开头附近说明作者是创始人、员工或贡献者。这是本站的透明度建议,可以帮助读者判断文中的选择和结论。
先让正文里的命令或示例返回预期结果,再链接完整文档、仓库或 Demo。讲到账号、价格或部署限制时,再给出相应说明页。只有功能列表、优惠和重复官网链接的文章,很难为开发者提供可以复现的过程。
标题和标签决定文章进入哪类阅读场景
标题写具体问题、技术对象或制作结果。例如,How I handled retries in a webhook SDK 比 The future of developer productivity 更容易判断。项目展示也可以直接写 I built...,但后半句应说明产品完成什么任务。
DEV 当前允许最多 4 个标签。#showdev(在新标签页打开) 用于展示完成的项目,tutorial 用于教学步骤,其他位置留给正文实际讨论的语言、框架或工程场景。不要因为某个标签热门就把无关文章放进去。
文章如果已经首发在自己的博客或公司网站,在 canonical_url 填原地址。转载本人旧文前,先确认自己仍有转载权。DEV 的反抄袭指南(在新标签页打开) 提醒作者,原出版方可能拥有相关权利。外部资料、代码和图片也应链接来源。
在 Create Post 完成草稿与发布
未登录时打开 Create Post(在新标签页打开),页面会显示登录或注册流程。Editor Guide(在新标签页打开) 当前说明,DEV 有基础 Markdown 和 rich + markdown 两种编辑方式。主要发布资料包括:
- 文章标题和完整正文;
- 最多 4 个标签;
- 可选的封面图,官方建议尺寸为 1000 × 420;
- 控制草稿或公开状态的
published,或当前编辑器里的Publish按钮; - 可选的
canonical_url和series。
Editor Guide(在新标签页打开) 明确写着,未发布文章,包括草稿和排期文章,其链接可以分享给合作者检查。页面会提示 This URL is public but secret。它们不会出现在信息流或个人主页,任何拿到链接的人仍然可以打开。不要在未发布文章里放 API Key、客户数据、内部地址或尚未公开的商业信息。
发布前预览代码块、图片替代文字、标题层级和外链。正文中的一级标题会与页面自动生成的文章标题重复,官方编辑指南建议正文从二级标题开始。
点击 Publish,或在基础编辑器中把 published 设为 true。生成正式文章 URL,并且文章能从作者主页打开,说明发布已经完成。随后检查选定标签页、代码渲染和移动端段落。进入 Relevant 或 Top 属于后续分发,不是发布成功的必要条件。
产品稿使用 AI 时有额外禁区
DEV 的 AI 文章规则(在新标签页打开) 允许 AI 辅助或生成内容,但要求用 #ABotWroteThis 或正文披露,并由作者核对事实。规则同时写明,AI 辅助或生成的文章不得推广任何 business、program 或 course,包括作者自己的企业、项目计划或课程。
因此,准备产品推广或 #showdev 文章时,应由实际参与产品、能够核对技术事实的人撰写,不要把 AI 起草或润色的稿件作为推广内容发布。AI 规则还禁止机器人或 AI 生成评论。基础翻译、语法改进和辅助技术工具属于评论规则列出的例外。
同一份规则还把以索取金钱、建立反向链接或欺骗读者为主要目的的文章列为可能导致停权或封禁的行为。个人博客链接,以及由公司 Organization 发布时指向公司博客的链接,是该规则写明的反向链接例外,但文章仍需符合社区内容要求。
把评论中的复现结果写回正文
读者在不同系统或版本中失败时,先询问环境、依赖和完整报错。确认命令过时就编辑原文,重要修改可以在正文末尾写明日期和版本。评论中出现更好的实现时,经过验证再补进文章,并标明贡献者和来源。
Organization 的官方帮助页列出浏览量、反应和行动按钮点击等统计。这些数字只说明内容在 DEV 上的表现。产品是否获得持续使用,仍要回到自己的注册、核心功能使用和留存数据。
决定文章类型后,依次检查示例能否复现、编辑器设置和公开页面:
- 决定写
#showdev项目展示、可复现教程,还是由团队 Organization 长期发布。 - 重跑代码或产品流程,记录环境、版本、限制和原始来源,并披露自己与产品的关系。
- 登录
Create Post,填写标题、正文和最多 4 个标签,转载内容补上canonical_url。 - 预览代码、图片和链接后公开发布,以正式文章 URL 和作者主页记录作为成功标志。
- 持续回答复现问题,并把已确认的修正写回原文。产品推广稿不要使用 AI 辅助生成。