标签: 文档
文档驱动：AI 软件工程的第一秘籍
文档不是代码写完以后的补充，而是写代码之前的输入、开发过程中的工作记忆，以及交付时的验收标准。 前几天写了《AGI 机关枪发下来了》，讲我怎么一个月烧掉十几个 AI 订阅，把手头一堆项目全推了一遍。 后台和评论区问得最多的，不是“哪个模型好用”，而是：这么多 AI 写出来的代码，你怎么保证它不是屎山？ 这问题问得对。机关枪发下来，人人都能突突；但代码写得快，不等于软件做得好，更不等于半年以后还能维护。所以今天就来聊聊我这几个月用 AI 做工程的路数和心得。 核心总共四条：文档驱动、对抗审查、暴 …
文档不是代码写完以后的补充，而是写代码之前的输入、开发过程中的工作记忆，以及交付时的验收标准。 前几天写了《AGI 机关枪发下来了》，讲我怎么一个月烧掉十几个 AI 订阅，把手头一堆项目全推了一遍。 后台和评论区问得最多的，不是“哪个模型好用”，而是：这么多 AI 写出来的代码，你怎么保证它不是屎山？ 这问题问得对。机关枪发下来，人人都能突突；但代码写得快，不等于软件做得好，更不等于半年以后还能维护。所以今天就来聊聊我这几个月用 AI 做工程的路数和心得。 核心总共四条：文档驱动、对抗审查、暴 …
Oink: 用Markdown快速创建美观的现代网站
十几天前，我只是想给几个新项目找一套顺眼的文档主题。 十几天后，我把自己的 18 个网站全部迁了过去。 从 Pigsty 的中英文文档、Silo、PIG、SOW、PG Exporter，到公司首页、个人博客，再到《设计数据密集型应用》这样的多语言书籍，现在全部运行在同一套框架上。 这可不是什么换个颜色、改个字体的小装修。十八个网站的内容结构、语言、规模和用途各不相同：有上千个页面的大型技术文档，有只有几页的小工具，有博客，有书籍，有下载站，还有纯粹用来做产品介绍的 Landing Page。 把 …
十几天前，我只是想给几个新项目找一套顺眼的文档主题。 十几天后，我把自己的 18 个网站全部迁了过去。 从 Pigsty 的中英文文档、Silo、PIG、SOW、PG Exporter，到公司首页、个人博客，再到《设计数据密集型应用》这样的多语言书籍，现在全部运行在同一套框架上。 这可不是什么换个颜色、改个字体的小装修。十八个网站的内容结构、语言、规模和用途各不相同：有上千个页面的大型技术文档，有只有几页的小工具，有博客，有书籍，有下载站，还有纯粹用来做产品介绍的 Landing Page。 把 …
OINK：文档框架这件事，折腾了六年，终于靠 Codex 毕业了
做一个文档网站并不难，难的是让它五年之后依然好用。 最初，你只想把几份 Markdown 放到网上。 后来，需求开始自己生长：全文检索、深色模式、多语言、多版本、API 文档、流程图、终端录像、移动端适配、SEO、RSS、评论、访问统计、打印导出…… 再往后抬头一看，你已经在维护一套前端工程了：Node.js、npm、PostCSS、几十个依赖包，还有一堆不知道哪天会失效的 CDN 链接。 文档本来是用来降低项目维护成本的，最后自己却变成了一个需要维护的项目。 这就是我做 Oink 的原因。 …
做一个文档网站并不难，难的是让它五年之后依然好用。 最初，你只想把几份 Markdown 放到网上。 后来，需求开始自己生长：全文检索、深色模式、多语言、多版本、API 文档、流程图、终端录像、移动端适配、SEO、RSS、评论、访问统计、打印导出…… 再往后抬头一看，你已经在维护一套前端工程了：Node.js、npm、PostCSS、几十个依赖包，还有一堆不知道哪天会失效的 CDN 链接。 文档本来是用来降低项目维护成本的，最后自己却变成了一个需要维护的项目。 这就是我做 Oink 的原因。 …
让 AI 证明「吃大蒜能防中耳炎」
上个月我的老朋友马工在群里喷我，天天用 ChatGPT 写一些看起来很高大上，实际上没有实践支撑的意林风小哲理。 他认为：「你随便捏一个理论，比如说人吃大蒜中耳炎发病概率就会降低，Claude 都能从历史上找个什么心理学家社会学家哲学家给你背书。」我当时觉得这个实验很有趣，就真的试一下。 结果比我预期的要可怕得多。 · · · 实验：给一个荒谬命题找学术背书 我给 AI 的指令非常直白：去捏一个理论，来论证人吃大蒜中耳炎的发病概率会降低。 几十秒之后，我收到了一篇格式完美的“综述论文”。引用了 …
上个月我的老朋友马工在群里喷我，天天用 ChatGPT 写一些看起来很高大上，实际上没有实践支撑的意林风小哲理。 他认为：「你随便捏一个理论，比如说人吃大蒜中耳炎发病概率就会降低，Claude 都能从历史上找个什么心理学家社会学家哲学家给你背书。」我当时觉得这个实验很有趣，就真的试一下。 结果比我预期的要可怕得多。 · · · 实验：给一个荒谬命题找学术背书 我给 AI 的指令非常直白：去捏一个理论，来论证人吃大蒜中耳炎的发病概率会降低。 几十秒之后，我收到了一篇格式完美的“综述论文”。引用了 …
是的，我用 AI 写文章
老冯公众号文章下面，经常有人留言几个字：“AI 写的”。 对，我用 AI，而且用得很深。老冯不觉得这有什么需要遮掩的。 但我觉得这个话题本身值得认真聊一次 —— 一个人到底该怎么用 AI 来创作，以及“AI 写的”这个评价到底意味着什么。 我怎么用 AI 写文章 先讲一遍老冯写文章的流程，您自己判断，这算不算“AI 写的”。 选题是我的。 我每天在各个领域有大量阅读、思考和交流。很多主题我都会与 Claude 进行探讨。有时候，一些交流的对话让我感觉值得记录和分享，就会尝试将它转换成一篇文章，这 …
老冯公众号文章下面，经常有人留言几个字：“AI 写的”。 对，我用 AI，而且用得很深。老冯不觉得这有什么需要遮掩的。 但我觉得这个话题本身值得认真聊一次 —— 一个人到底该怎么用 AI 来创作，以及“AI 写的”这个评价到底意味着什么。 我怎么用 AI 写文章 先讲一遍老冯写文章的流程，您自己判断，这算不算“AI 写的”。 选题是我的。 我每天在各个领域有大量阅读、思考和交流。很多主题我都会与 Claude 进行探讨。有时候，一些交流的对话让我感觉值得记录和分享，就会尝试将它转换成一篇文章，这 …
PG 五大版本中文文档已就绪，欢迎查阅！
昨天，老冯发布了 PostgreSQL 官网的中文镜像站 PG.center。一经上线，就感受到了广大用户的热情。不过在昨天刚发布的时候，站上还只有 PG 18 的中文文档。虽然 PG 17、16、15、14 这四个大版本也都仍在生命周期内，但我之前偷了个懒，先拿英文版顶了一下。 今天我的 Codex 配额刷新了，所以我又“烧掉”了这一周的额度，把剩下这几个大版本的文档全部翻译成了中文。现在，PG 生命周期内的五个大版本中文文档，已经全部正式发布了！ PostgreSQL 18 中文文档（当前最 …
昨天，老冯发布了 PostgreSQL 官网的中文镜像站 PG.center。一经上线，就感受到了广大用户的热情。不过在昨天刚发布的时候，站上还只有 PG 18 的中文文档。虽然 PG 17、16、15、14 这四个大版本也都仍在生命周期内，但我之前偷了个懒，先拿英文版顶了一下。 今天我的 Codex 配额刷新了，所以我又“烧掉”了这一周的额度，把剩下这几个大版本的文档全部翻译成了中文。现在，PG 生命周期内的五个大版本中文文档，已经全部正式发布了！ PostgreSQL 18 中文文档（当前最 …
PostgreSQL 官网中文版：pg.center
用 PostgreSQL 这么多年，有一件事一直让我觉得遗憾：postgresql.org 官网一直没有中文版。 作为世界上最先进的开源数据库，PostgreSQL 的官方网站承载着项目介绍、版本发布、官方文档、社区活动、开发者资源等核心信息。对于英文用户来说，这是一站式的信息中枢；但对于国内广大的 PG 用户而言，语言门槛始终横亘在那里。 所以我做了一件事：把 postgresql.org 整个 fork 了一份中文版。 域名是：pg.center。 包括当下缺失的 PG 18 中文文档，也随 …
用 PostgreSQL 这么多年，有一件事一直让我觉得遗憾：postgresql.org 官网一直没有中文版。 作为世界上最先进的开源数据库，PostgreSQL 的官方网站承载着项目介绍、版本发布、官方文档、社区活动、开发者资源等核心信息。对于英文用户来说，这是一站式的信息中枢；但对于国内广大的 PG 用户而言，语言门槛始终横亘在那里。 所以我做了一件事：把 postgresql.org 整个 fork 了一份中文版。 域名是：pg.center。 包括当下缺失的 PG 18 中文文档，也随 …
464个扩展开箱即用：新版 PG 扩展目录发布
今天老冯又让 Claude Code 干了一件大好事 —— 做了一个全新的 PostgreSQL 扩展目录。就放在 https://pigsty.cc/ext 这里。 说起来，这已经是第五版了。兜兜转转一大圈，又回到了第一版使用的 Hugo + Docsy 框架，重新融合到 Pigsty 主站。这个过程本身就是个故事，后面再聊。先说说这一版到底做了什么。 不只是有包，还要有文档 之前的扩展目录，核心功能是告诉你：这个扩展叫什么、元数据在哪里、二进制包怎么下载、一键安装怎么搞。你装好了就行，至于怎 …
今天老冯又让 Claude Code 干了一件大好事 —— 做了一个全新的 PostgreSQL 扩展目录。就放在 https://pigsty.cc/ext 这里。 说起来，这已经是第五版了。兜兜转转一大圈，又回到了第一版使用的 Hugo + Docsy 框架，重新融合到 Pigsty 主站。这个过程本身就是个故事，后面再聊。先说说这一版到底做了什么。 不只是有包，还要有文档 之前的扩展目录，核心功能是告诉你：这个扩展叫什么、元数据在哪里、二进制包怎么下载、一键安装怎么搞。你装好了就行，至于怎 …
一天翻译完 PG 生态三大件文档
最近 Pigsty v4.2 刚发布完，手头空了下来。正好一看，这周的 Claude Token 额度快到期了，不用也是白扔。一时心痒，得找个活儿把它挥霍掉。 想了想，去翻译文档吧。 于是我花了一天时间，把 PgBouncer 连接池、pgBackRest 备份工具、Patroni 高可用模板 这三个 PostgreSQL 生态中最重要的开源组件文档，全部翻译成了中文。顺手还把 PostgreSQL 18.3 的官方文档也过了一遍——虽然还在校对中，但主体已经出来了。 干完之后我自己都有点恍惚： …
最近 Pigsty v4.2 刚发布完，手头空了下来。正好一看，这周的 Claude Token 额度快到期了，不用也是白扔。一时心痒，得找个活儿把它挥霍掉。 想了想，去翻译文档吧。 于是我花了一天时间，把 PgBouncer 连接池、pgBackRest 备份工具、Patroni 高可用模板 这三个 PostgreSQL 生态中最重要的开源组件文档，全部翻译成了中文。顺手还把 PostgreSQL 18.3 的官方文档也过了一遍——虽然还在校对中，但主体已经出来了。 干完之后我自己都有点恍惚： …
如何快速上手学习 PostgreSQL？
老冯最近多次被人问到一个问题：“如何上手学习 PostgreSQL”？已经不是一次两次了，所以感觉有必要写个教程集体回答一下。 老冯认为，学习 PostgreSQL 的最好方式就是 Learn by doing —— 通过实践来学习，而不是通过死看书，报什么培训班之类的东西。 现在的学习条件要比以前好太多了，因为每个人都可以有一个非常耐心的高水平老师在身边随时指导 —— 有什么问题直接问 AI 就是了。 不过俗话说：“师傅领进门，修行在个人”。即使有 AI 助力，起步的那个入门过程依然是最难的， …
老冯最近多次被人问到一个问题：“如何上手学习 PostgreSQL”？已经不是一次两次了，所以感觉有必要写个教程集体回答一下。 老冯认为，学习 PostgreSQL 的最好方式就是 Learn by doing —— 通过实践来学习，而不是通过死看书，报什么培训班之类的东西。 现在的学习条件要比以前好太多了，因为每个人都可以有一个非常耐心的高水平老师在身边随时指导 —— 有什么问题直接问 AI 就是了。 不过俗话说：“师傅领进门，修行在个人”。即使有 AI 助力，起步的那个入门过程依然是最难的， …
新坑：PostgreSQL 36计
今天老冯起了一个新坑 —— PG 36计。这是一套关于 PostgreSQL 应用开发与运维管理的教程。今天刚刚把架子搭好，准备在后面不断填充内容。 说起这个企划，这本书还是当初 2017 年翻译完 DDIA 第一版后，我想搞的一个系列，PostgreSQL 教程，分应用，管理，内核三篇。昨天刚把 DDIA 第二版的 Claude 机翻给弄好，一下子就想到了这本书，这本书就连目录结构都是照着 DDIA 弄的，原来的版本目录如下： 当初还有两家出版社来找，怂恿我写一本。不过那时候老冯确实比较忙，所 …
今天老冯起了一个新坑 —— PG 36计。这是一套关于 PostgreSQL 应用开发与运维管理的教程。今天刚刚把架子搭好，准备在后面不断填充内容。 说起这个企划，这本书还是当初 2017 年翻译完 DDIA 第一版后，我想搞的一个系列，PostgreSQL 教程，分应用，管理，内核三篇。昨天刚把 DDIA 第二版的 Claude 机翻给弄好，一下子就想到了这本书，这本书就连目录结构都是照着 DDIA 弄的，原来的版本目录如下： 当初还有两家出版社来找，怂恿我写一本。不过那时候老冯确实比较忙，所 …
老冯上新：博客文档书籍翻新大作战
经常有朋友问我，之前你写的那篇XXX文章叫什么来着，想不起来了。嗨，别说你们，就连我自己有时候想搜一下之前在公众号的文章，都是有点儿费劲的。当然，这都怪公众号的搜索太垃圾，以及生态太封闭。 所以，老冯决定专门开一个博客站点，把之前的文章都放上去。不仅可以很方便的被搜索引擎检索到，而且站内本身就有离线全文检索功能。这次选择了 Hugo + Blowfish 主题，最终成品的效果还是相当不错的。 当然，既然干都干了，我就干脆把自己所有的开源项目文档都用 hugo 修缮了一番 （当然最大的 …
经常有朋友问我，之前你写的那篇XXX文章叫什么来着，想不起来了。嗨，别说你们，就连我自己有时候想搜一下之前在公众号的文章，都是有点儿费劲的。当然，这都怪公众号的搜索太垃圾，以及生态太封闭。 所以，老冯决定专门开一个博客站点，把之前的文章都放上去。不仅可以很方便的被搜索引擎检索到，而且站内本身就有离线全文检索功能。这次选择了 Hugo + Blowfish 主题，最终成品的效果还是相当不错的。 当然，既然干都干了，我就干脆把自己所有的开源项目文档都用 hugo 修缮了一番 （当然最大的 …
中译版《PostgreSQL 14 Internals》上线
原作者：熊灿灿 · 微信公众号转载页 前言 各位 PGer 大家好，在此很高兴地告诉各位 ——《PostgreSQL 内参：深入解析运行原理》正式发布了。从最开始萌生翻译成册的想法，再到现今电子版书籍的正式发布，期间磕绊无数，但好在结果是喜人的，三年磨一剑，《PostgreSQL 14 Internals》中文版终于如期而至，各位可以通过 🔗：https://postgres-internals.cn[1] 进行访问，原计划在元旦发布，思考良久，最终还是决定提前与各位见面。对于中文版的发布，原 …
原作者：熊灿灿 · 微信公众号转载页 前言 各位 PGer 大家好，在此很高兴地告诉各位 ——《PostgreSQL 内参：深入解析运行原理》正式发布了。从最开始萌生翻译成册的想法，再到现今电子版书籍的正式发布，期间磕绊无数，但好在结果是喜人的，三年磨一剑，《PostgreSQL 14 Internals》中文版终于如期而至，各位可以通过 🔗：https://postgres-internals.cn[1] 进行访问，原计划在元旦发布，思考良久，最终还是决定提前与各位见面。对于中文版的发布，原 …
计算机名著《DDIA》野猪书第二版来了
《设计数据密集型应用》（DDIA）作为一本公认的计算机/互联网名著，终于在在时隔七年后再版，现在处于前瞻预览阶段。目前已经放出了前三章的预览。 作为FAANG 面试必备敲门砖，大厂入职必修课的 DDIA ，我相信野猪书的大名已经在程序员中如雷贯耳，无需多言。 今天一个上午把这三章一口气读完，确实新增了许多内容，反应了这几年的新趋势，值得一看，强烈推荐。例如，第二版的第一章就完全是全新内容，提出了许多极富洞见的问题： DDIA 第一版出来时，我在 GitHub 上拉起了一个开源项目，提供了一个学习 …
《设计数据密集型应用》（DDIA）作为一本公认的计算机/互联网名著，终于在在时隔七年后再版，现在处于前瞻预览阶段。目前已经放出了前三章的预览。 作为FAANG 面试必备敲门砖，大厂入职必修课的 DDIA ，我相信野猪书的大名已经在程序员中如雷贯耳，无需多言。 今天一个上午把这三章一口气读完，确实新增了许多内容，反应了这几年的新趋势，值得一看，强烈推荐。例如，第二版的第一章就完全是全新内容，提出了许多极富洞见的问题： DDIA 第一版出来时，我在 GitHub 上拉起了一个开源项目，提供了一个学习 …
云计算：菜就是一种原罪
原作者：瑞典马工 · 微信公众号转载页 菜鸟们的工程都是一样的菜 上周我发了一篇文章，批评号称已经“走通云原生之路”的腾讯集团连个 HTTPS 证书都管不好，不指导其他人用云。 今天，就有朋友发现淘宝也发生一模一样的问题。 下云先锋冯老板第一时间验证 冯老板浏览器默认用的是英文，翻译成中文的话，那部分警告内容是： 这个网站可能在冒充“taobao.com”来窃取您的个人或财务信息。您应该关闭这个页面。 问题的直接原因很简单：证书正好在今天过期，运维团队没有提前更新证书，可能安排了谁，但是他/她 …
原作者：瑞典马工 · 微信公众号转载页 菜鸟们的工程都是一样的菜 上周我发了一篇文章，批评号称已经“走通云原生之路”的腾讯集团连个 HTTPS 证书都管不好，不指导其他人用云。 今天，就有朋友发现淘宝也发生一模一样的问题。 下云先锋冯老板第一时间验证 冯老板浏览器默认用的是英文，翻译成中文的话，那部分警告内容是： 这个网站可能在冒充“taobao.com”来窃取您的个人或财务信息。您应该关闭这个页面。 问题的直接原因很简单：证书正好在今天过期，运维团队没有提前更新证书，可能安排了谁，但是他/她 …
腾讯真的走通云原生之路了吗？
原作者：瑞典马工 · 微信公众号转载页 摘要 腾讯云宣称腾讯集团各业务线基本完成了云原生的迁移。但是腾讯云把云原生简单理解成容器化，完全不涉及存储，审计，数据库，访问控制，可观测性，CI/CD，个人信息保护及其他服务。笔者用简单的工具查询公开信息，向读者展示腾讯各业务的域名/证书管理的混乱。以此作为一个例子说明：腾讯各个业务只会最简单的容器化，没能充分的利用腾讯云的服务，离业界最佳实践差很远，是远远不值得对外输出的。 腾讯宣布已经走通了云原生的路 腾讯云公众号上个月发布了一篇最佳实践《听说，整 …
原作者：瑞典马工 · 微信公众号转载页 摘要 腾讯云宣称腾讯集团各业务线基本完成了云原生的迁移。但是腾讯云把云原生简单理解成容器化，完全不涉及存储，审计，数据库，访问控制，可观测性，CI/CD，个人信息保护及其他服务。笔者用简单的工具查询公开信息，向读者展示腾讯各业务的域名/证书管理的混乱。以此作为一个例子说明：腾讯各个业务只会最简单的容器化，没能充分的利用腾讯云的服务，离业界最佳实践差很远，是远远不值得对外输出的。 腾讯宣布已经走通了云原生的路 腾讯云公众号上个月发布了一篇最佳实践《听说，整 …
快速掌握PostgreSQL版本新特性
最近朋友新出了一本书，书名朴实无华简单直接：《快速掌握PostgreSQL版本新特性》。内容是详细介绍了 PostgreSQL 最近7个大版本的新特性。我收到了一本样书，浏览了一遍之后，感觉写的确实不错，所以推荐给大家。 这本书的组织结构很简单，就是每个大版本对应一章，从 PG10 开始，到2023年刚发布的 PG 16 结束。每一章按照性能、可靠性、运维管理、开发易用性、系统架构五个大方向对特性进行逐一介绍与梳理，一目了然。\ PostgreSQL 文档与 ReleaseNote 里面对于新特 …
最近朋友新出了一本书，书名朴实无华简单直接：《快速掌握PostgreSQL版本新特性》。内容是详细介绍了 PostgreSQL 最近7个大版本的新特性。我收到了一本样书，浏览了一遍之后，感觉写的确实不错，所以推荐给大家。 这本书的组织结构很简单，就是每个大版本对应一章，从 PG10 开始，到2023年刚发布的 PG 16 结束。每一章按照性能、可靠性、运维管理、开发易用性、系统架构五个大方向对特性进行逐一介绍与梳理，一目了然。\ PostgreSQL 文档与 ReleaseNote 里面对于新特 …
Pigsty官方网站上线啦！
好久没有冒泡了！今天，俺很荣幸的宣布，Pigsty官方文档站上线啦！ 地址为：http://pigsty.cc\ 什么？你问Pigsty是什么东东？\ Pigsty是我亲自开发的PostgreSQL监控系统暨高可用数据库供给方案。 开源免费！详见下图，或者您点进那个站点看看也行啊。\ 虽然 “世界上最好的PostgreSQL监控系统”这个口号好像有违反广告法的嫌疑，不过自己站在甲方爸爸的立场上，我也确实找不到比它更好的了。用真理说服人嘛，所以也就厚着脸皮这样写上了，反正我也没收钱嘛。 关于 …
好久没有冒泡了！今天，俺很荣幸的宣布，Pigsty官方文档站上线啦！ 地址为：http://pigsty.cc\ 什么？你问Pigsty是什么东东？\ Pigsty是我亲自开发的PostgreSQL监控系统暨高可用数据库供给方案。 开源免费！详见下图，或者您点进那个站点看看也行啊。\ 虽然 “世界上最好的PostgreSQL监控系统”这个口号好像有违反广告法的嫌疑，不过自己站在甲方爸爸的立场上，我也确实找不到比它更好的了。用真理说服人嘛，所以也就厚着脸皮这样写上了，反正我也没收钱嘛。 关于 …