This is not really a suggestion for a new documentation style but rather a setting for existing ones. All C and C++ styles start with @brief/\brief and then the description. Doxygen has an autobrief setting where it uses the first sentence before a . as the brief, thus making @brief/\brief unnecessary.
Duplicating the existing set of styles just for that one is probably not the best idea, but rather the introduction of a configuration that decides whether or not the brief part is written
This is not really a suggestion for a new documentation style but rather a setting for existing ones. All C and C++ styles start with @brief/\brief and then the description. Doxygen has an autobrief setting where it uses the first sentence before a . as the brief, thus making @brief/\brief unnecessary.
Duplicating the existing set of styles just for that one is probably not the best idea, but rather the introduction of a configuration that decides whether or not the brief part is written