软技能

指标读者本课程的指标读者为已实现技术写作 第一课[1]，然而依然渴望进行更多写作培训的人员。如果你没有承受过任何技术写作的培训，最好先看一下第一课能容。 学习指标这节课侧重于技术写作中的几个两头主题，学习完本课程之后，将播种如下的常识： •从几种不同的策略中抉择一种编写第一稿的策略，以及第二稿、第三稿的其余策略。•应用多种技术来检测写作中的谬误。•学会组织大型的文档。•介绍文档的范畴和所有先决条件。•写下清晰的图形题目。•在技术插图中抉择适当的信息密度。•将读者的注意力集中在插图上。•通过图片建设上下文。•无效的批改技术插图。•创立有用、精确、简洁，清晰，可重用和正文良好的代码，用来演示一系列的复杂性。•标示不同的文档类型。•形容所有的内容。•谅解初学者，并为他们编写教程。 成为一名优良的工程师或者优良的技术作家都须要破费多年的专一实际，这门课程能进步你的写作水平，但不会立刻使你成为一个杰出的作家。 自我编辑参考《Google开发分档格调指南[2]》 换位思考： •尝试从读者的角度浏览文档，确保文档目标是明确的；并思考好不同的角色所领有的常识储备。•而后从作者的角度浏览文档，确保你做的假如有用，还能够提供资源的链接。•最初请留神，过分依赖角色，会导致文档过于狭窄，而无奈对大多数读者有用。 大声读出来： •本人大声的朗诵或者应用屏幕阅读器朗诵，来听取难堪的措辞，简短的句子或其余不天然的内容。 编写每一搞的策略： •编写完每一个版本之后，先放边上一个小时，而后再回来浏览一遍，总会发现有能够改良的中央，举荐做三遍。 查看写作中的谬误： •邀请某人查看你的文档，并给你具体的，建设性意见。•浏览的人不肯定是同行，然而最好相熟你遵循的文档格调。 写一个大型文档应用以下策略能够帮忙你们撰写大型文档： •抉择编写单个大型文档或一组简短文档。•把简短文档整顿为一个大型文档。•给大型文档增加导航。•逐渐裸露信息。 什么时候写大文档： •当你的浏览对象是刚入门的读者时，写操作指南、入门概述和概念性指南通常能以短文的模式提供更好的作用。•当曾经对工具和主题有肯定教训的读者，写深刻教程，最佳实际指南和命令行参考页能够作为更长的文档应用。•好的教程能能够依附叙述来疏导读者实现较长文档中的一系列相干工作。 写较长文档的办法： •创立纲要和起草宣言。•实现初稿之后，能够更具概述和简介对其进行复审。 编写纲要的实用技巧： •在要求读者执行工作前，先解释为什么要执行此工作。•将纲要的每个步骤限度为形容概念或实现特定工作。•结构轮廓，以便文档在与读者最相干时引入信息。•在起草前，先与贡献者共享纲要内容。 能够提供一个根本信息来介绍文档： •阐明文档涵盖的内容。•心愿读者具备哪些常识储备。•阐明文档没有涵盖那些内容。 为文档增加目录，可确保读者能疾速的找到所须要的内容，清晰的目录包含： •简介和摘要•主题清晰•有助于用户了解的题目和子标题•提醒用户在目录中的地位•能够通过目录能跳转到相干地位•有下一步学习的链接 在每个题目下都进行简短的介绍，防止在题目前面马上放入下一级题目。 图片在插入图之前写题目会很有帮忙，而后，插入能阐明题目的图片 图片中好的题目应该具备上面的特色： •他们很简短，通常只是几句话。•阐明了重点。•能吸引读者的注意力。 思考以下三个图形，每个图形应用雷同的题目。 题目A。单链接列表蕴含内容和指向下一个节点的指针。 题目B。单链接列表蕴含内容和指向下一个节点的指针。 题目C。单链接列表蕴含内容和指向下一个节点的指针。 上述三个题目中题目C是最具启发性的，题目清晰的形容了图片的性能。 如下图片中的信息量不要过大。 如上图的复杂性就会让很多读者望而生畏，就像防止过长的句子一样，请尽量避免较简单的图片。 将简单的图片变为连贯且有用的窍门是将简单的零碎组织成子系统。 图4.分为三个子系统的简单零碎。 显示大图之后再别离提供每个子系统的图片。 图5.简单零碎的一个子系统的扩大细节。 画图工具 •Google绘图[3]•diagrams.net[4]•lucidchart[5] 创立示例代码代码依然是技术人最喜爱读的，好的代码通常是最好的文档。 好的代码样本是正确、简洁，你的读者能够疾速了解它们，并能以最小的代价重复使用它们。 正确示例代码应该满足上面条件： •代码构建没有谬误。•能按要求进行执行。•要做好生产应用的筹备，比方，代码不能有安全漏洞。•遵循语言的约定。 简洁示例代码应该简短，仅包含根本组件，不相干的代码可能会使你的读者扩散注意力。然而，也不要用谬误的做法来缩短你的代码，在正确和简短之间，咱们更看重正确性。 References[1] 技术写作 第一课: _https://lengrongfu.github.io/... [2] Google开发分档格调指南: _https://developers.google.com... [3] Google绘图: _https://drawings.google.com/_ [4] diagrams.net: _https://diagrams.net/_ [5] lucidchart: _https://www.lucidchart.com/pa...

金字塔原理 ——表达的逻辑无论工作还是学习中，思考、表达和解决问题的能力都是每个人的必备技能。学习金字塔原理，能帮助我们更好地拥有这些技能。为什么用金字塔原理金字塔的内部结构如何构建金字塔两个方法：将思想组织成金字塔序言演绎推理和归纳推理日常应用：一个例子：应用金字塔结构，整理需要转达的信息，先说明主要目的，减少沟通成本。约求职者来公司面试过程中，需要转达疑问：以下是我向leader转达信息的过程：

软技能：代码之外的生存指南从2019年计划说起2019年我计划过要读很多书，这本书并非我今年看的第一本书，但我一定要第一个推荐它：给各位从事软件开发行业的人员们。我自己就是从事游戏开发的一名普通的程序员。这本书我是在浏览廖雪峰的博客时无意之中发现的:)。很偶然的机会，之前从来没有听身边人或者网上有人讨论过这本书。但我觉得所有从事软件行业的，尤其是程序员们应该好好看看这本书。这本书的名字虽然提到了“代码”这个熟悉的不能再熟悉的词，可是整本书却丝毫没有谈到或者教导读者如何写好代码之类的话题。但是这本书所谈论的话题恰恰是软件行业从事人员最容易忽视的一些对你一生都至关重要的东西：健康、理财、人际交往、自我营销、积极的人生态度。一想到这里，我就会联想到国内一些程序员过劳死的新闻。。。《代码整洁之道》作者Robert C. Martin为本书作序想必大多数的程序员都看过或者听说过这本书吧。不过我自己到现在还没怎么看呢????，作者有幸可以邀请到如此大牛为他的书作序，我当时看了，也惊讶不已。说明《软技能》这本书的作者在圈内影响力还是不小的，这也激发了我当时阅读此书的好奇心。关于《软技能》这本书的内容这本书对软件开发人员来说，可以说是除了没有谈论如何码代码之外，其他的所有事情差不多都谈到了： 人际交往、面试之道、自我定位、如何晋升、创业、自我营销、学习、专注力、番茄工作法、责任心、时间杀手、习惯的力量、行动力、理财投资、健身、积极的心态、甚至连期权交易、股市以及恋爱关系都有提到。 强烈推荐各位抽空看看这本书！对我来说很有用的一些话题（我会定期重读这些内容，在这里顺便做个标记）人际交往请勿陷入对技术的狂热之中自我营销学习怎样学习对自己负责时间杀手分解任务：如何吃掉一头大象任何行动都比不采取行动要好理财、健身积极的心态曾经的观念在信息时代，客观障碍已不复存在，所谓障碍都是主观上的。如果你想研发什么新的技术，你不需要几百万美元的资金，你只需要在冰箱里放满比萨和可乐，再有一台便宜的计算机，和与之献身的决心，你即可拥有任何你想拥有的编程境界！这是美国著名的游戏程序员：约翰·卡马克说过的一句话,这位大佬凭借自己出色的游戏编程能力在1999年硬是登上了时代周刊，可想而知有多牛叉！几年前，小白的我刚看到这句话时，真的是大受鼓舞，恨不得可以天天上班。。。