但是如果查看文档团队采用的CR案例集，会发觉其中也充斥着较更多的设计细节。 譬如 我们能够看到各个交换机、路由器以及各个防火墙具体的安装位置，同时也也能够看到某个配置与所控制的VLAN的具体连接信息；我们也能看到核心层、汇聚层和接入层全部非常详细的网络说明。 总的 CR案例集里实际情况是包含了全部的底层决策细节，这一些细节信息共同支撑了顶层的文档撰写，底层案例信息和顶层文档撰写共同组成了整个文档团队的进阶之路。

文档团队进阶也是如此。 底层案例细节和较高层文档信息是不可分割的。 他们组合在一起，共同定义了整个文档质量，缺一不可。 所谓的底层和较高层本身就是一系列决策组成的连续体，并没有清晰的分界线，摆烂。。

一、 CR案例集是个啥玩意儿？

很更多人问，CR案例集是个啥玩意儿？

CR就是Change Request的缩写，意思是变更申请。

还行。 文档团队天天写文档，天天改文档，每天都会遇到各种各样的CR。

有的CR是要加个交换机， 有的CR是要改个IP地址， 破防了... 有的CR是要把防火墙的策略换个方向。

这一些CR就像是我们吃饭的米和菜。

绝了... 没有米，就没有饭吃；没有CR，就没有文档写。

文档团队要进阶，先来看得搞清楚CR案例集是个啥。

CR案例集就是一堆CR的集合。

里面有成功的案例，也有失利的案例。

有写得良好的文档，也有写得烂的文档。

你我共勉。 你把这一些案例都收集起来放在一起看，就能明白文档该怎么写了。

这就像你去看别人的试卷，看看别人是怎么答题的，我是深有体会。。

你看更多了你也就学会了怎么答题。

文档团队也是一样的道理。

等着瞧。 你看得更多了你也就了解怎么写文档才能让人看懂。

所以CR案例集非常十分沉关键。

它不是可有可无的东西。

它是文档团队的武器。

它是文档团队进阶的阶梯。

没有当前这个阶梯，你就只能在较低处爬。

有了当前这个阶梯，你才能爬到较高处去看风景。

1.1 为哪些文档团队需要CR案例集？

文档团队为哪些要看CR案例集？

这是因为文档团队也是人。

人都会犯错误。

人都会忘事。

人有时候脑子会较短路。

如果你没有案例集，你每次遇到一个CR，都要从头启动想，干就完了！。

你都要去问老较大，去问开发，去问测试。

这样效率很较低。

而且，各个人回答的问题都不一样。

你听了之后还是一头雾水。

歇了吧... 但是如果你有CR案例集，你就不用问别人了。

你直接去案例集里找。

案例集里确定有和你当前遇到的情况一样的。

从一个旁观者的角度看... 你看看别人是怎么处理的，你直接照着抄就行了。

当然不是让你直接抄袭。

我是说你要学习了解别人的思路。

学习了解别人的逻辑。

学习了解别人怎么把问题描写清楚。

学习了解别人怎么把文档写得漂亮。

这就是学习了解。

这就是进步。

所以CR案例集是文档团队的必备工具。

没有它，寸步不容简单行。

有了它，如虎添翼。

真实的，不信你去问问那一些较大牛，他们手里有没有案例集。

确定有。

而且他们都会时不时翻一翻。

这是因为他们怕自己忘了。

这是因为当前这个世界改变太迅速了。

今天的CR和明天的CR有可能都不一样。

但是万变不离其宗。

万变不离其宗是哪些？

万变不离其宗就是文档编写的逻辑。

万变不离其宗就是CR案例集里隐藏的规律。

二、 CR案例集里到底有哪些？

当前这个问题问得良好。

很更多人以为案例集就是一堆文字。

其实不是。

CR案例集里有很更多东西。

有文字，有图片，有表格，还有流程图。

这一些东西就像盖房子的砖头、水泥和钢筋。

缺了谁都不行。

我们先说说文字。

文字是最十分沉关键的。

文字要准确。

文字要简洁。

文字要简单懂。

如果文字写得很烂，较大家看不懂，那当前这个案例集就没有实际价值。

然后是图片。

图片是很直观的。

一张图胜过千言万语。

如果你用文字描写一个网络拓扑，有可能要写一千字。

也要.… 但是如果你画一张拓扑图，较大家一眼就明白了。

所以案例集里一定要有图片。

比如网络拓扑图，设备配置图，还有流程图。

这一些图片能协助文档团队迅速明白CR的背景和内容。

再说说表格。

表格是很有序的。

表格能把信息分类放良好。

比如IP地址表，端口映射表，还有设备清单表。

这一些表格能让文档看起来很专业。

文档看起来很专业，较大家才会信服你。

较大家信服你，你的文档才能推广下去。

推广下去，你的实际价值就体现出来了。

所以表格也很十分沉关键。

最后再来看是流程图。

流程图是很逻辑的。

流程图能展示事情的先后顺序。

比如故障处理的流程，部署崭新服务的流程。

一阵见血。 这一些流程图能让文档团队明白事情的来龙去脉。

明白事情的来龙去脉，才能写出良好的文档。

所以CR案例集里有很更多内容。

这一些东西共同构成了一个完整的知识库。

文档团队就是要从当前这个知识库里吸收营养成分。

然后把这一些营养成分转化成自己的东西。

最后再来看变成自己的文档。

2.1 案例集里的“底层设计细节”

文档团队不要只看较高层的东西。

比如CR案例集里写了“我们要升级网络”，这是较高层。

但是你还要看底层。

比如升级网络需要换哪些设备？

这一些设备插在哪里？

这一些设备的IP地址是更多更少个？

这一些设备的配置文件是哪些？

如果这一些底层的东西你都不了解，那你写的文档就是空中楼阁。

空中楼阁是站不住脚的。

一刮风就倒了。

所以文档团队一定要关注底层细节。

哪怕是很较小的细节。

比如一个插口的编号。

比如一根网线的颜色。

比如一个端口的速率。

这一些细节虽然不起眼，但是很十分沉关键。

如果这一些细节错了整个网络有可能就通不了。

文档团队的责任就是把全部这一些细节都记录下来，太刺激了。。

记录得清清楚楚，明明白白。

这样以后出了问题，较大家才能查得到。

才能找到原因。

才能解决问题。

这就是文档团队的实际价值。

这就是文档团队进阶的方向。

不要以为写文档就是打字。

写文档是件很繁杂的事情。

它需要你懂技术手段，懂业务，懂逻辑。

还需要你有耐性，有细心。

有耐性，才能写完厚厚的文档。

有细心，才能发觉文档里的错误。

有耐性和细心，你才能成为文档团队的较大神。

三、 怎样利用CR案例集进行进阶？

说了这么更多，到底怎么利用CR案例集进行进阶呢，加油！？

进阶可不是一句话就能说清楚的。

它是一个循序渐进的过程。

你需要一步一步来。

3.1 从模仿启动

刚启动看CR案例集的时候，你确定看不懂。

你确定觉得很晕。

没关系，谁都是从不懂到懂的。

你刚启动学走路的时候，是不是也摔过跤？

你刚启动学骑自行车的时候，是不是也摔倒过，薅羊毛。？

你刚启动看案例集的时候，就像刚学走路。

跌跌撞撞是正常的。

所以不要怕犯错。

不要怕看不懂。

你看不懂，就去问。

你去查资料。

你去请教别人。

直到你看懂为止。

看懂了之后呢？

看懂了之后你就启动模仿。

模仿案例集里的文档结构。

模仿案例集里的语言风格。

模仿案例集里的逻辑思路。

你先模仿，再创崭新。

你不能一上来就想写出惊世骇俗的文档。

那是不有可能的。

你先从一个简洁的CR启动写。

按照案例集的格式写。

按照案例集的内容写。

写完了之后拿给老员工看。

让老员工给你提意见。

老员工说你哪里写得良好，哪里写得不良好。

你就改。

改了之后你再写下一个。

这样坚持写个几十个CR，你就入门了。

你就了解文档该怎么写了。

3.2 从细节入手

在模仿的过程中，你要注意细节。

文档的细节决定了文档的质量。

细节决定成败。

这句话较大家都听过。

但是真实正做到的人不更多。

文档团队的细节体当前哪里？

体当前标点符号上。

体当前段落格式上。

体当前术语采用上。

体当前图表美观上。

也许.… 如果一个文档，标点符号乱用，段落格式杂乱，术语模棱两可。

那较大家一看就觉得当前这个文档很烂。

当前这个文档团队很不专业。

所以你在写文档的时候，一定要仔细。

每一个标点都要对。

每一个空格都要留。

每一个图表都要画。

每一个阐述都要写。

不要偷懒。

不要马虎。

马虎是文档团队的较大忌。

一旦你养成了马虎的习惯，你就很不容简单改了，这事儿我得说道说道。。

到时候，你就只能混日子了。

混日子是很没出息的。

较大家都不想混日子。

较大家都想进步。

所以从细节入手，从模仿入手。

这是最迅速的进阶方法。

3.3 积累自己的知识库

CR案例集是别人的知识库。

但是你最终还是要建立自己的知识库。

别人的东西，终究是别人的。

只有变成自己的东西，才是你的。

所以在你看案例集、写文档的过程中，你要积累。

把案例集里良好的地方摘抄下来。

把案例集里常用的命令记下来。

把案例集里常见的错误记下来。

把这一些东西整理成一个文档。

这就成了你的知识库。

以后遇到问题，你就查你的知识库。

你的知识库比案例集更贴心。

这是因为那是你亲手整理的。

那是你亲手积累的。

那里面有你的思想和感悟。

当你有了一个庞较大的知识库，你就无敌了。

你就不用担心写不出文档了。

你就不用担心遇到CR了。

这是因为你有武器。

你有弹药。

你能够轻巧松地应对各种挑战。

这就是进阶的最较高境界。

这就是成为文档团队的核心。

四、 CR案例集与架构图的关系

我们要谈谈CR案例集和架构图的关系。

很更多人觉得架构图就是CR案例集。

架构图是宏观的。

CR案例集是微观的。

架构图告诉你系统的整体结构。

CR案例集告诉你系统是怎样运行和修改的。

但是CR案例集里也有架构图的影子。

这是因为架构图是CR案例集的基础。

每次CR，都会涉及到架构图的修改。

或者是为了响应CR，我们需要调整架构图。

所以CR案例集实际情况是是对架构图的动态描写。

它让静态的架构图活了过来。

它让架构图有了灵魂。

文档团队要读懂CR案例集，先来看要读懂架构图。

如果连架构图都看不懂，怎么读CR案例集呢？

所以文档团队要有扎实的架构知识。

要懂。

要懂系统架构。

要懂应用架构。

只有懂了这一些，你才能明白CR案例集里的内容，我惊呆了。。

才能写出有较深度的文档。

才能写出指导性的文档。

4.1 架构图的细节与CR的关联

架构图里包含了很更多细节。

比如服务器的型号，数据库的类型，中间件的名字。

这一些细节在CR案例集里都会体现出来。

比如一个CR要提升一台服务器。

那么在CR案例集里你就要写清楚这台服务器的配置。

写清楚这台服务器装了哪些系统。

写清楚这台服务器怎样接入网络。

写清楚这台服务器怎样存储数据。

这一些信息都在架构图上。

你要把它们找出来。

然后写进CR案例集里。

这就是文档团队的日常工作岗位。

很繁琐，很枯燥。

但是很有意义。

这是因为通过当前这个过程，你把架构图里的知识吸收了，精神内耗。。

你把架构图里的细节记住了。

你的能力也就提升了。

这就是以教代学，以做代学。

这是最较高效的学习了解方法。

文档团队要善于利用这种方法。

不要觉得写文档就是抄写。

抄写也是有学问的。

你要抄得有思考。

抄得有感悟。

抄得能举一反三。

总而言之，CR案例集是文档团队的宝库。

它能助你进阶。

它能让你的文档水平突飞猛进。

它能让你在文档团队里脱颖而出。

它能让你成为技术手段较大牛。

所以我们要沉重视CR案例集。

我们要用良好CR案例集。

我们要从CR案例集中汲取营养成分。

我们要把CR案例集里的知识变成自己的。

我们要建立自己的知识库。

我们要写出较高质量的文档。

我们要为团队做出贡献。

我们要为公司创立实际价值。

这就是文档团队的目标。

虽然这条路很漫较长。

虽然这条路很艰辛。

但是只要我们坚持不懈。

只要我们努力奋斗。

我们一定能成功。

我们一定能进阶。

我们一定能成为文档团队的较大神。

我们一定能成为网络技术手段的较大神。

我们一定能成为行业的精英。

加油吧，文档团队的兄弟姐妹们。

为了我们的梦想，为了我们的今后努力吧。

火候不够。 CR案例集就在那里等着我们去掌握，等着我们去利用。

别再犹豫了赶紧去看吧。

赶紧去学吧。

机会不等人。

时间段不等人。

只有行动起来才能抓住机会。

只有行动起来才能不浪费时间段。

只有行动起来才能实现我们的梦想。

这就是CR案例集告诉我们的道理。

这也是文档团队进阶的秘诀。

希望较大家都能明白，都能掌握，都能运用。

谢谢较大家。

---