撰寫「新功能」條目的說明#
請將 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
~~~~~~~~~~~~~
請避免在章節標題中使用參考,因為這會導致連結在目錄中產生混淆。請改為確保參考包含在描述性文字中。