练习清晰-这是一种理智的形式吗?

很难知道我们的专业角色在哪里结束,以及我们其余的身心(我想是灵魂)在哪里。

当然,这前提是您是专业人士还是非专业人士之间确实存在差异。

就我而言,这种预设几乎存在于我的每个层面。

例如,作为技术作家,我不断挑战作为作家的投资。 那是因为我一直在写作和阅读—在工作中,在家中,而不是在家中不工作。 阅读,写作。 主要是小说。 日记。

介绍清晰度

我仅以一种写作为生-开发人员的技术内容以及对了解我公司产品的技术性质感兴趣的其他任何人的技术知识。 我会努力以一种任何人都可以理解的语言进行写作,而又不会浪费任何材料,否则我将失去我的主要听众。

但我确信,只要页面上其他有生命力的迹象(例如代码,图表,(一些)技术术语和项目符号)还可以,任何人都可以踢起脚来享受阅读我的文档的乐趣。 这是因为整个框架包含一种讲故事和用语,能清晰,热情地讲述技术。

我乐于编写技术内容,首先是因为我喜欢写作,其次,在我的所有写作中, 清晰度是关键。 即使我像在这里那样从事小说,日记或博客日记,也要保持清晰明了,其中的素材会进入和退出我相当活跃的白日梦状态。 我认为所有的编写过程都会使复杂性变得清晰。

注入一点歧义

在所有辉煌的过程中阐明复杂性不仅很有趣,而且也是必要的。 但是清晰并不排除歧义。 有时,我喜欢刻意地模糊或使我的写作充满歧义-我在各种意识和潜意识的感觉中遇到的都是虚假但大多是真实的歧义。 对我来说,承认,列出并确实造成歧义是确保真实与清晰地接近的肯定方法。

但我会傻傻地相信开发人员在阅读有关如何编写出色的应用程序时需要模棱两可。

因此,在我的日常工作中,模棱两可毫无目的,也没有明显目的。 但是我坚信即使是最有功能的写作,在从事任何新工作之前,至少也必须提高歧义。 没有更好的方法来知道您写的内容是否确实清晰,或者是否会变成不受限制,不受限制,容易受到多种解释,破坏整个项目或创建大量支持单的想法。 在其他方面,您如何评估开发人员阅读者阅读您的文本时理解或思考的内容? 严格意义上讲并不能消除歧义。 否则,它是牙齿切口 -切得太近,在疼痛处切开。

歧义及其解决方案营造出温暖,舒适的清晰度。

亲爱的清晰,让我向您介绍歧义

嗯,无论如何,就像我在开始时说的那样,很难在专业人士和个人之间划清界限,尤其是当该界限定义您在公司产品和底线的高度轮廓世界中属于谁时,将您与其他人区分开来您的倾向…

但是要保持清晰度-这是一种理智的形式吗? -使得在两者之间切换似乎一切正常。