编辑“WordPress内嵌文档”（章节）

==需添加内嵌文档的代码==
全局文档为阅读源代码的 phpDocumentor和其它程序提供了如何使用全局变量的信息。由于核心开发人员可能并不接受补丁，因此这类信息并不是必须具备的，而且多数情况下也是不必要的。

函数和类方法通常要放在一定的文本环境中才有意义，而文档就是用来提供这个文本环境的，但内嵌文档不应当提供极端例子，除非在codex信息不能及时获得的小行代码中。

WordPress中使用的多数类都是单件（所有函数都包含在一个类中），但是它们经常要求手动初始化属性。很多情况下，何时在类中使用方法并不明了。

新添加的类及一些外部类库常使用多个类来形成函数库，这就创建了更多需要学习的新类（，因为基类（即开发人员使用的用来从其它类中提供函数的类）并不明确。这时，给中类层次库的类添加文档可使类功能更加清晰。

为了使类文档完整，应给类的属性添加文档。类的PHPdoc标签可以在其主网站找到，以下也有示例：
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*