OpenAI 发表了一篇《怎样才算好文档》的指南，很值得学习，最核心的一点：写文档是一种同理心的体现很多开发者在写文档的时候估计都没有站在阅读这些文档的开发者的角度去思考这个问题，比如大家吐槽良多的支付宝的文档、微信的开发文档😂里面有几个要点：- 让文档易于“扫读” →

发布时间: 2025-10-21 10:30:17

1分

数据加载中

关注推特

收听电报

2

1

0

OpenAI 发表了一篇《怎样才算好文档》的指南，很值得学习，最核心的一点：写文档是一种同理心的体现
很多开发者在写文档的时候估计都没有站在阅读这些文档的开发者的角度去思考这个问题，比如大家吐槽良多的支付宝的文档、微信的开发文档😂
里面有几个要点：
- 让文档易于“扫读” →
IT技术
( twitter.com )

7小时前由宝玉提交

OpenAI 发表了一篇《怎样才算好文档》的指南，很值得学习，最核心的一点：写文档是一种同理心的体现

很多开发者在写文档的时候估计都没有站在阅读这些文档的开发者的角度去思考这个问题，比如大家吐槽良多的支付宝的文档、微信的开发文档😂

里面有几个要点：
- 让文档易于“扫读” → 标题要清晰、段落要简短、多用项目符号和粗体
- 写得简单点 → 少用行话、避免缩写、即便是“显而易见”的步骤也要解释清楚
- 提供“通俗易懂面向普通人”的帮助 → 文档不只是给专家看的，而是给所有人看的
- 按价值排优先级 → 优先解决常见问题，避免教人坏习惯

完整文档：https://t.co/EHAPRU2Cnc
翻译：https://t.co/Yz141lnp7p

点击图片查看原图

Markdown支持

评论加载中...

您可能感兴趣的：更多

1

2

1

1

在Stripe播客中，OpenAI 联创兼总裁Greg Brockman 透露了OpenAI发展的关键内幕。他表示规模假说并非OpenAI的初始战略，而是2017年在 Dota 2 项目中意外发现——每当计算资源翻倍，AI表现就相应提升，这一发现彻底改变了AI研究方向。
OpenAI
时政
( twitter.com)

1个月前 • 西乔 XiQiao • -- 点击 0 评论

2

2

1

1

OpenAI 揭秘：AI为什么会一本正经地胡说八道？
OpenAI 最近发表了一篇名为《语言模型为何会产生幻觉》(Why Language Models Hallucinate) 的文章，深入解释了 AI “幻觉”产生的根本原因，并提出了减少这种现象的解决方案。
规则的“锅”：AI 被鼓励去猜测，而非承认无知
IT技术
( twitter.com)

1个月前 • 宝玉 • -- 点击 0 评论

3

3

2

2

大四本科生发15篇SCI论文，初中就已申请发明专利？5月7日，一篇获奖文章介绍，来自重庆大学的大四学生刘培乔，发表十余篇SCI论文以及获得多项国家发明专利。刘培乔发表SCI一区期刊论文5篇、SCI二区期刊论文9篇；获国家发明专利授权3项。引发大众质疑。
时政
( twitter.com)

5个月前 • 李老师不是你老师 • -- 点击 0 评论

4

2

1

1

OpenAI 官方放出 Sora 的支持国家列表
看来今晚总算要来了
IT技术
( twitter.com)

10个月前 • orange.ai • -- 点击 0 评论

5

2

1

1

今天写了两篇长文有点累，换换脑筋，刚群友发给我这个，深表赞同。
我说怎么入圈也没比孙哥他们晚多少，怎么就不能跟他们一样成功呢？
问题找到了！
现在 234 都有了，1 需要再努努力，向和这样的币圈成功男人看齐！
btc
( twitter.com)

6个月前 • 土澳大狮兄BroLeon • -- 点击 0 评论

6

2

1

1

DeepSeek 发布了一个新型 OCR文档理解模型：DeepSeek-OCR
它不仅解析图像文档达到了一流水平
还探索出了一个大胆的想法👇🏻
大语言模型（比如 GPT）在处理长文章时，消耗的计算量会爆炸性增长。
但如果把文字“画成图片”，模型只需要很少的“视觉 token”就能理解同样内容。
时政
( twitter.com)

18小时前 • 小互 • -- 点击 0 评论

7

2

1

1

凌晨谷歌发布的flash thinking版，算是对标o1了，这一波google算是迎头追上了，尤其是多模态的卡位基本上当下就是no1，总算是可以彻底不用openai了。
除了测试之外我已经快将近3个月没怎么用过openai了，现在使用大模型的能力上：
1、编程用claude，开源用qwen-instruct32b coder
2、compute
时政
( twitter.com)

10个月前 • AIGCLINK • -- 点击 0 评论

8

2

1

1

漏了！OpenAI原本打算开放权重的模型泄露了！
刚才 HuggingFace 上有人上传了 openai-oss-120B 和 openai-oss-20B 模型, 立刻整合了所有信息给大家做一个解读。
首先最重要的是 120B 那个是个 MoE，激活参数大概是 5B，128 专家每次激活 4 个专家。原生只有 4K 上下文，通过 YaRN 扩展到
时政
( twitter.com)

2个月前 • karminski-牙医 • -- 点击 0 评论

9

2

1

1

比较好奇币安合约上已经到一小时结算的币费率没那么夸张之后，怎么样才能恢复到4/8小时结算…比如说Sign这种
btc
( twitter.com)

5个月前 • Rui • -- 点击 0 评论

0.10009 Second , Gzip Enable.本网所有言论均来自网络，不代表本网站立场。联系方式: [email protected]

©2012.11.21 bad.news All rights reserved. 社区自动运营第 -- 年零 -- 天
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

关注推特