Moved the release notes and added more description to the release notes.

Author: MalavikaSamak

clang-tools-extra/clang-tidy/bugprone/SizeofExpressionCheck.cpp

@@ -379,6 +379,8 @@ void SizeofExpressionCheck::check(const MatchFinder::MatchResult &Result) {
     auto Loc = Result.Nodes.getNodeAs<Expr>("sizeof-expr");
 
     if (const auto type = dyn_cast<ArrayType>(SizeofArgTy)) {
+      // check if the array element size is larger than one. If true,
+      // the size of the array is higher than the number of elements
       CharUnits sSize = Ctx.getTypeSizeInChars(type->getElementType());
       if (!sSize.isOne()) {
         diag(Loc->getBeginLoc(), "suspicious usage of 'sizeof' in the loop")

clang-tools-extra/docs/ReleaseNotes.rst

@@ -146,6 +146,13 @@ Changes in existing checks
   <clang-tidy/checks/bugprone/optional-value-conversion>` check to detect
   conversion in argument of ``std::make_optional``.
 
+- Improved :doc: `bugprone-sizeof-expression
+  <clang-tidy/checks/bugprone/bugprone-sizeof-expression>` check by adding
+  `WarnOnSizeOfInLoopTermination` option to detect misuses of ``sizeof``
+  expression in loop conditions. The check detects the use of ``sizeof``
+  opertaor to determine the number of elements in the array, where the
+  array size is higher than the number of elements in the array.
+
 - Improved :doc:`bugprone-string-constructor
   <clang-tidy/checks/bugprone/string-constructor>` check to find suspicious
   calls of ``std::string`` constructor with char pointer, start position and
@@ -219,11 +226,6 @@ Changes in existing checks
   tolerating fix-it breaking compilation when functions is used as pointers
   to avoid matching usage of functions within the current compilation unit.
 
-- Improved :doc: `bugprone-sizeof-expression
- <clang-tidy/checks/bugprone/bugprone-sizeof-expression>` check by adding
- `WarnOnSizeOfInLoopTermination` option to detect misuses of ``sizeof``
-  expression in loop conditions.
-
 Removed checks
 ^^^^^^^^^^^^^^