From ef9088408b353a38f52d0542f1bca8c1ff7a14ff Mon Sep 17 00:00:00 2001 From: JAROWMR Date: Tue, 3 Dec 2024 21:38:21 +0100 Subject: Added doxygen features tab standard to contributing --- contributing.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'contributing.md') diff --git a/contributing.md b/contributing.md index b0f623b..85e29bb 100644 --- a/contributing.md +++ b/contributing.md @@ -953,6 +953,23 @@ that you can click on to open them. Foo & operator=(Foo &&) = delete; ``` +- Features are described in the Doxygen Feature Tab (in this order): + - A feature description should explain the purpose and function of the feature, + focusing on what it enables or achieves for the gamedeveloper. + - Include additional information about when to implement the feature, + such as specific use cases or scenarios. + - Provide an example to demonstrate how gamedevelopers can enable or use the feature. + + - If the current feature depends on or reuses a previous feature, + include a link to that feature from the current feature (backward link, if applicable). + + - If the current feature depends on or reuses a previous feature, + include a link from the previous feature to the current feature (forward link, if applicable). + + > [!NOTE] + > A feature is almost never a component, system or large part of the engine. + > If a component or system has a single, + > distinct feature it should be named after that feature, not the component or system itself. # Libraries -- cgit v1.2.3