通过GitBook打造自己的知识体系
2017-09-14 / modified at 2024-03-02 / 451 words / 1 mins

在学习了新知识后,需要总结与验收

什么是GitBook

GitBook是一个基于md格式的在线文档SAAS服务,当然也可以自己搭建到Github Pages等托管平台,通过GitBook可以构建自己目录与笔记等知识体系,最终积累成一本书。

举个例子,这位网友开发了一个“LeetCode解题”,左边目录,右边文档。这样他以后再也不用担心任何算法题了。

再举一个例子,我在工作项目中维护了一份项目文档,里面描述了技术架构,运维实现,内部原理,以及新员工相关的环境搭建,Rally/JIRA的使用等流程,这样无论是离职交接还是新员工入职都很快能够上手。

这里的Gitbook只是一个简单的例子,目前开源版的Gitbook已经死了,可以选用其它的文档工具

方法分享

我的解决方法是博客与GitBook同时使用,具体如下

  • 结构化且需要耗费时间
    • 博客: 开源项目分析,非技术随笔,技术与非技术书评,心得等零散化的知识
    • Wiki: 技术详细体系(后端/JDK/JVM源码实现),注意这个体系,如果网上已经有人写过了,那么我不推荐从零开始做,而是推荐在他人的基础上补全与修正,否则这份总结的工作就成负担了
  • 临时与速记
    • 云笔记,非结构化,notion等
  • 长期任务
    • 日历
    • 备忘录

收费方案:

  • Azure DevOps: 小团队全功能免费,支持层次结构,最推荐
  • backlog:有Wiki,但是没有层次
  • Confluence:Spend less time hunting things down and more time getting things done. Organize your work, create documents, and discuss everything in one place.