学不会真的不是你的错,平坦的官方文档真的不适合初学者
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
以上是关于学不会真的不是你的错,平坦的官方文档真的不适合初学者的主要内容,如果未能解决你的问题,请参考以下文章