学不会真的不是你的错，平坦的官方文档真的不适合初学者
Posted 韩旭051
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了学不会真的不是你的错，平坦的官方文档真的不适合初学者相关的知识，希望对你有一定的参考价值。
构建文档系统
最近一直在研究 文档系统 相关的工作，刚好看周志明老师的《凤凰架构》这本书 提到了 一些关于 官方文档 和 初学者 入门学习 相关的思考，把这段话抽象出来 做了一个 整理提炼。
官方文档的主要作用是参考手册，
它并不会告诉你 各种概念的演化历程、版本发布新功能的时间线、改动的缘由与背景等信息。文档系统只会以“平坦”的方式来陈述所有目前可用的功能，
这有利于熟练的管理员快速查询到关键信息，
却不利于初学者去理解设计思想，
由于难以理解那些概念和操作的本意，
往往只能死记硬背，
也很难分辨出它们应该如何被“更正确”的使用。
介绍 设计理念的职责，只能由官方的 Blog这类定位超越了帮助手册的信息渠道，
或者其他非官方资料去完成。
周志明《凤凰架构-构建可靠的大型分布式系统》P315页 13.1 k8s存储设计
Kubernets 官方文档的主要作用是参考手册，它并不会告诉你 Kubernetes 中各种概念的演化历程、版本发布新功能的时间线、改动的缘由与背景等信息。Kubernetes 的文档系统只会以“平坦”的方式来陈述所有目前可用的功能，这有利于熟练的管理员快速查询到关键信息，却不利于初学者去理解 Kubernetes 的设计思想，由于难以理解那些概念和操作的本意，往往只能死记硬背，也很难分辨出它们应该如何被“更正确”的使用。介绍 Kubernetes 设计理念的职责，只能由Kubernetes 官方的 Blog这类定位超越了帮助手册的信息渠道，或者其他非官方资料去完成。本节，笔者会以 Volume 概念从操作系统到 Docker，再到 Kubernetes 的演进历程为主线，去梳理前面提及的那些概念与操作，以此帮助大家理解 Kubernetes 的存储设计。
《凤凰架构-构建可靠的大型分布式系统》P315页 13.1 k8s存储设计
http://icyfenix.cn/immutable-infrastructure/storage/storage-evolution.html
以上是关于学不会真的不是你的错，平坦的官方文档真的不适合初学者的主要内容，如果未能解决你的问题，请参考以下文章