写给新手作者的一封信

引言

如果你曾在高科技环境中工作过，你可能会发现，在某些情况下，专家级别的人和试图摆脱初学者水平的初学者之间存在很大的差距。更具体地说，专家级别的人没有时间一步步地指导初学者完成诸如校准仪器、运行机器，甚至编写内核级代码的过程。因此，当涉及到建议或批评时，初学者不应该将任何事情放在心上。CodeProject 是一个网站，它为任何有驱动力的人提供了大量关于系统编程、应用程序编程、组件开发以及任何与计算机科学相关的主题的信息。这自然导致其成员由专家级和初学者级组成。但初学者的首要目标应该是学习文章提交向导并熟悉 HTML。

初学者应该引用来自教育来源的任何材料，避免傲慢，尊重那些会审查文章的人，并避免任何讽刺性的亵渎。通常在写作中，初学者可能会发现一些作者有一种用一个段落来表达本可以用一句话表达的内容的方式。也许，有些著名的教科书作者是按字数收费的。然而，最好使用像项目符号这样的词，避免写出冗长而脱节的散文。例如，考虑以下关于引用类型和值类型的描述

引用类型将它们的数据的地址（也称为指针）存储在堆栈上。该地址指向的实际数据存储在称为托管堆的内存区域中。运行时通过一个称为垃圾回收的过程来管理堆使用的内存。垃圾回收会定期根据需要回收内存，方法是处理不再被引用的项目。另一方面，值类型是包含其直接值而不是包含对存储在内存其他位置的数据的引用的变量。值类型的实例存储在称为堆栈的内存区域中，运行时可以在该区域中快速创建、读取、更新和删除它们，且开销最小。

上面的示例段落不仅定义了引用类型和值类型，还定义了它们之间的区别。请注意，它没有说明：“引用类型是一种存储...”。也许可以将值类型描述为作为线程堆栈上字节序列内联分配的变量。那么重点是什么？嗯，一些读者会马上理解这个主题，而其他读者可能没有任何概念。诚然，很难确定读者会理解什么，不会理解什么。但是，这种差异来自于没有专注于思考读者具备什么水平的知识。因此，一个好的做法是首先编写一个大致的草稿。通读并大声朗读。问问自己，它是否断断续续，是否从一个主题跳到另一个主题？阅读该粗略草稿可以提醒作者从一个通用的方法开始，并说明文章的目的。后面的部分应该按照该目的依次编写。粗略地说，首先以通用性陈述目的，然后将其分解为具体的子组件部分。

如果你是初学者，请避免复杂的编程主题

如果任何初学者阅读过 CodeProject 上关于 COM 的任何文章，那么该初学者会注意到，书面材料表明对组件对象模型编程和以有条理、有序和专业的方式撰写文章都有详细的了解。学习他们的技巧，他们如何概述，如何开始，以及如何总结。但是，如果你是初学者，请不要尝试撰写关于 COM 的文章，因为它是一种复杂的编程实践。最后，始终检查 HTML，以确保您的标题、段落、有序列表、无序列表和图像标签与用于代码块的 pre 标签对齐。一开始可能看起来有点困难，但是只要有积极的态度，你的文章将会演变成“艺术品”。

历史

• 2009 年 6 月 23 日：首次发布