TBD
TBD
TBD
# | Abbreviation or Acronym | Definition |
---|---|---|
1 | Doxygen | Doxygen is a documentation generator and static analysis tool for software source trees. When used as a documentation generator, Doxygen extracts information from specially-formatted comments within the code. |
2 | MVC | Model–view–controller (usually known as MVC) is a software design pattern commonly used for developing user interfaces that divides the related program logic into three interconnected elements. This is done to separate internal representations of information from the ways information is presented to and accepted from the user |
The C++ code shall be documented using Doxygen to increase testability, supportability and maintainability. The following requirements shall be applied for the C++ code:
- Each source file shall have copyright header as shown below;
/*!
* \file FVABaseDictionaryItem.h
* \copyright Copyright 2021 FVA Software. All rights reserved. This file is released under the XXX License.
* \author Dima Nikulin.
* \version 0.29
* \date 2014-2022
*/
- Each class shall have a header to describe the class purpose like here
/*!
* \brief FVAOrganizerEventCfgPage is a child of QWizardPage and implements the next UI functions:
*
* 1. "Explanation words" to user in a QLabel;
* 2. "See input dir" button (QPushButton) to open input dir where processed files are in.
* 3. QTextBrowser to output the logging events;
* This class implements "View" functions from MVC pattern.
*/
class FVAOrganizerEventCfgPage : public QWizardPage
{
}
- Each global constant shall be documented with "\brief" like here:
/*!
* \brief id for any object that is not defined
*/
const int FVA_UNDEFINED_ID = -1;
- Each public function shall have a description of purpose, each parameter description and description of return value as well. Please see for example below:
/*!
* \brief it returns an ID value from file by file path provided
* \param file - path to file that contains the ID
* \param int& - variable to fill up by ID loaded from the file
* \returns it returns code of error if any or FVA_NO_ERROR if loading was successful
*/
FVA_EXIT_CODE fvaGetIDFromFile(const QString& file, int& ID);
The Python code shall be documented by TBD The following requirements shall be applied for the python code:
- TBD
README.MD file must be present in each source folder to describe the directory sources. This resource might help
# | Name | Source | Release date | Author | Description |
---|---|---|---|---|---|
1 | Markdown Cheatsheet | Web | |||
2 | Documenting python code | Web |