编写“新功能”条目的说明#
请将 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
~~~~~~~~~~~~~
请避免在章节标题中使用引用,因为这会导致目录中的链接混乱。 相反,请确保在描述性文本中包含引用。