程序员与作家

容易找到具有极端邪恶(我不是说坏实际上意味着好,我是说坏坏)的编码人员。 我认为这是一个很好的起点。 好吧,由于一个原因,我是一个非常糟糕的作家(读完这篇文章后请告诉我我是否仍然是)。 但是为了写机器,我们在写人类方面会更好吗?

用杰夫·阿特伍德的话(《恐怖编码》)

当然,编写计算机可以理解的程序具有挑战性。 这就是为什么只有很少的人能够胜任编程人员的工作。 但是,写出您的同伴可以理解的段落和句子-好吧,这更加困难。

艰难的事情

当您想到撰写博客时,为人们撰写文章的想法在作为开发人员时变得更加恐怖。 然后,您会开始记住一些事情。

1.语法。
2.词法结构。
3.形容词(该死的形容词)

还有更多的东西,仔细看看这些又是什么。

Grammer :我不太确定我确切地记得这是什么,就像编译器的语义分析器一样,检查语法树是否遵循语言规则构造。

词法结构 :确保各个词传达特定的含义。

形容词:那些可以帮助您描述某些事物并更好地描绘的词语,将它们视为laravel的外观(非常漂亮的功能)。

但是,您开始记得起步时必须经过的所有那些写得不好的软件文档,那是当它真正使您“难以编写”时。 您应该真的在英语课上听过。

但是现在还不算太晚(我认为?),任何开发人员的愿望都是成为社区的灯塔(至少那是我的)。

分解

程序员在哪里写以及他们为什么写。

独自编写已经足够困难,但是开发人员确实喜欢编写,毕竟我们每天都尽其所能地编写代码,就像我们学会编写代码的方式一样,我们也学会编写,开始时肋骨开始断裂考虑我们在为谁写作。 基本上是两类。

程序员(文档兄弟)
非程序员(博客和技术讲座)

在我看来, 程序员更容易编写代码,但是简单并不一定意味着容易(请参阅我在那做的事?)。

为其他开发人员写书需要一个人从本质上很好地看一下软件,模块,api(或只是代码),并仔细详细说明其工作原理,以帮助下一个可能想要尝试将其变成炸弹的人。 这种写作形式在文档,自述文件和许多其他书面作品中很常见。

简而言之,就像编码是一门艺术一样,写作也是一门艺术,这就是为什么为非程序员 (那些实际上会在现实生活中使用该软件的人)编写问题的原因(有趣的是,有时我们忘记了用户,这就是自私)。

这些人的真正任务是调校代码老板(当开发人员撰写有关OAuth无状态身份验证之类的方法,方法,函数等等时,敬畏的开发人员会惊叹不已)。

在这种情况下,是时候像普通人一样开始交流了,开始使用寓言来描述各种api以及如何使用它们。

那么,这一切如何让您与想要编写代码的编码人员有关。

基本上是按特定顺序说以下

代码博客 :在编写代码博客时,详细说明如何执行过程或集成API,那么您需要从头开始进行解释,习惯于真正分解内容,并解释每个细节。 并且尽可能清晰,并且记住演示很重要。 这就是Github发挥作用的地方,您可以创建仓库来解释过程。

文档 :您在此处编写文件以全面解释您的创作,以便其他编码人员对它有所了解,以便他们可以使用它来构建更好的东西(例如Apollo 11)。

日记:是的,我知道这听起来可能很奇怪,但是日记对于开发人员跟踪进度和工作流程很重要,并且在适当的时候可以很容易地写出来有趣。

结论

写作并不难,尽管过程可能会时不时增加压力,并且实际上您有时会遇到作家的阻碍,但这是它自己的奖励,可以帮助他人了解您的创作。 它促进了协作和发展速度。

写作很容易,您要做的就是清除错误的单词

马克·吐温