媒介：

这篇是一篇番外篇，没有太多代码与逻辑，完全是一种”软“能力，可是它对付你如何成为一名合构的架构设计人员很重要。

在此要澄清一点，架构师自己也是”措施员“，不是光动嘴皮子的家伙们，假如你不是一名措施虽身世那你基础谈不上也不行能成为一名架构师。

那么架构师尚有哪些是作为一名措施员来说不具备的呢？

个中有一项本领就叫做”文档写作本领“。

一、Soft Skill与Hard Skill

作为一名架构师除了是一名资深的措施员外，它还必需具有相应的Soft Skill，个中有一名就叫做Documentation Skill。

1. 先来说一下Hard Skill

代码与框架以及产物的机动利用以及在相应的domain（如Insurance, Banking, CRM, DW。。。）上的履历我们把它称为Hard Skill，没有这些能力你就成不了一名及格的措施员。

措施员和IT是有区此外，措施员是IT业内的主力军团，可是假如你是在一家网站可能是软件司作需求阐明的，哪怕是一个秘书，那你也是一个IT人员，对吧？所以这些对象是一个成为架构师的“硬”条件。

2. 什么是Soft Skill

Soft Skill即指Documentation Skill, Presentation Skill，Communication Skill, 相应的Language Skill（不包罗日本语，BS小日本）, Management Skill, Leader Ship, 这些.

虽然，尚有更多，更多。。。

2.1 Documentation Skill与Presentation Skill

本日主要报告的是Documentation Skill与Presentation Skill。

勿要小看这两点，有人说他本身编程编得好，有人说本身的算法写了如何如何博识，那么。。。在此刻这个团队相助至上以及处于今朝这样的世界经济大情况以客户至上的配景下你所知道的的对象不能向其它人表达清楚，谁会领略你的想法，谁会接管你的理念，谁会选择你公司的产物呢？

举两个例子：

苏步青，他是大数学家，对吧，或者不少人不知道苏步青在文学上的造诣也是很深的。

苏步青曾说过：为什么我喜欢语文，语言，因为我的论文，我的课本需要用语言去表达的，假如不把语言，语文学好我基础无法更精准更大白的去表达我的算法。

著名计较机学者C语言教程的作者谭好强曾经说过：可以或许把巨大的问题用简朴直白的语言和框图去表达出来，就是最好的论文。

再说个实际点的例子，你处于一个投标比赛中，你的设计或者是很好，但是如何让客户可以或许领略和接管贵公司的设计方案呢？

那么你需要在平时有意识的去提高可能我们说修练一下你的documentation skill，documentation skill与presentation skill是接洽在一起的.

2.2 要善于分明“包装”

Presentation Skill即”宣传、演示、演讲、推销”的一种能力，许多人在面临你的同事可能伴侣时大概会滚滚而谈，可是在面临你的上司可能是在客户眼前，就成了“缩货”了。。。为什么？

其实许多时候在于你演讲的稿本我们一般用PPT可能是WORD筹备的不敷，机械、凡味，尚有时在于你的设计确实本身也拿捏禁绝。

因此Hard Skill是你的底气，有了足够硬的Hard Skill你有了50%的胆量再加上一篇好的Document（PPT一类）你的另50%胆量也有了，此时你的Presentation Skill就晋升了.

所以许多时候你的Presentation Skill是便是Hard Skill+Documentation Skill的。

有一部片叫《幸德勒的名单》相信不少人看过吧？开头30分钟，靠着不敷万元“老本”的幸德勒来到了犹太人聚积地，找到了犹太管帐师-以撒.斯坦，他滚滚而谈本身创立公司的打算，如何可以挣钱。然后以撒.斯坦问了他一句：

请让我弄大白一件事，我出人，然后我找”金主“出钱，那你出什么。。。？

幸德勒吸了一口烟，双手合在一起后向外一推 ”presentation, 这是我最擅长的“，这边的presentation也可认为是一种包装.

同样一其中国出产的杯子和美国，假如机能、成果、利用寿命都一样，相信必然是美国货卖得贵，为什么？因为它在有了Hard Skill基本上再次举办了”包装“，这就是”好莱坞式”的促销手法。

要学会“包装”但不是扯蛋和吹牛，劳务派遣管理系统，因为架构师拿出来的对象哪怕再大度，假如没有内含那也是“滥竽凑数”，被人识破后就一钱不值了。可是我们在有好的质量好的技能的基本上善于去“包装”它，相信你会离乐成更近一步。

三、如何写好一篇文档和提高你的documentation skill

我在前公司有一阵没空，一度让其它几个senior的Team Leader辅佐我写文档，要求把设计凭据需求可以或许写清即可。

奉上来5篇文章，根基一篇都不能用.

第一次奉上来，昆山软件开发，每篇都是讲一个成果点，要不是冗长的一段没意义的表明，要不就是从官网直接COPY一段话下来，甚至连1,2,3,4都没列出来，至少你要有个Advantage Points 可能说是Benefit和Disadvantage Points的比拟吧.

第二次奉上来，有了1，2，3，4，可是这下好了，全都标成1,2,3,4了。