编写“新增内容”条目的说明#
请将 whats_new.rst
的新内容放置到 doc/users/next_whats_new/
目录中。
添加条目时,请查看当前已有的文件,看是否可以对它们进行扩展。如果您创建一个文件,请将其命名为类似 cool_new_feature.rst
(如果您添加了全新功能)或类似 updated_feature.rst
(用于现有功能的扩展)。
请包含以下形式的内容
Section title for feature
-------------------------
A bunch of text about how awesome the new feature is and examples of how
to use it.
A sub-section
~~~~~~~~~~~~~
请避免在章节标题中使用引用,因为这会导致目录中的链接混淆不清。相反,请确保在描述性文本中包含引用。