跳到主要内容

写在前面:为什么我决定搭一个属于自己的博客?

阅读需 3 分钟
Walter

你好,我是桂陈(Walter),欢迎来到我的博客 Flowing Docs / 桂桂的知流小记。

其实想写博客已经很久了,只是一直拖着没动手。这次终于下定决心,先写篇文章立个 flag,免得自己又半途而废。写博客对我来说,就是找个地方把零散的想法整理出来,分享出去。我总觉得,如果一篇技术文章能让读者少走一些弯路,那这篇文章就发挥了它最大的价值。

Flag

很多技术人都搭过博客,但写了几篇就停了。希望我能坚持下去。

这个博客会写些什么?

博客与生活

图片来自 suksao | Freepik

做技术文档这几年,我发现要把文档写好并不容易。除了技术基础,更重要的是理解用户需求,最好还能有点产品和市场的视角。

所以我打算记录一些技术传播过程中的想法和经验,也当作自己的反思和总结。可能是因为性格原因,我特别在意用户体验——总想把复杂的技术概念用最简单、最准确的方式表达出来,让读者读起来不费劲。

主要会围绕这些方向:

  • 技术写作与文档工程

    分享一些在 Docs as Code 实践、内容架构设计、内容复用过程中,积累的经验和踩过的坑,希望能帮到有需要的人。

  • 开发者体验(DX)与技术传播

    多多站在用户角度思考问题:这段文字对新手友好吗?这个例子能说明问题吗?怎么把技术语言翻译成用户能理解的表达——这些既是我日常工作的重点。

  • AI 与开源工具实践

    尝试各种 AI 工具,比如内容自动校验、智能发布,优化写作和生产工具链。作为一个喜欢把事情做到极致的人,我对能提升效率和质量的工具特别感兴趣。

  • 生活随笔与技术折腾

    骑行故事、DIY 硬件、家庭实验室的折腾记录,作为生工作之外的放松。

总之,这里是我在技术文档路上的成长记录。如果你也关注技术传播、开发者体验、AI 工具,或者博客搭建,欢迎常来看看。

博客取名的故事

对于选择困难者来说,给博客取名确实太难了,想了很久,最后定了“知流小记”这个名字,它包含了我的职业理念和个人风格。

  • :代表着知识的积累与探索,是通过写作不断整理、反思与深化的过程。
  • :象征着知识的流动与传播,我相信,只有通过分享与交流,知识才能真正得到应用与价值的延续。
  • 小记:意在突出记录的随性与灵活,不拘泥于形式,及时捕捉从日常工作与思考中涌现的灵感与启发,见证个人成长与变化。

而域名 FlowingDocs.com 是灵光一闪想到的。当时正好想到知识如水般流淌的画面,我的英文名 Walter 又和 Water 发音相近,正好对应“让文档如水般流动”的寓意。

所以,“知流小记”不仅是个名字,更像是个提醒:记录知识流动的点点滴滴,让这些文字被更多人看到和使用。

既然立下了这个 flag,我一定会努力坚持下去。如果有一天发现这里很久没更新了,欢迎来催更😂。

接下来要写些什么?

下一篇,我会记录一下这个博客的搭建过程和一些调整经验。如果你对用 Docusaurus 搭建博客或文档平台感兴趣,欢迎关注!

感谢你耐心看到这里,我们下篇见!

Loading Comments...