chore: apply suggestions from code review

Co-authored-by: Athan <[email protected]>
Signed-off-by: Philipp Burckhardt <[email protected]>

Author: Planeshifter

lib/node_modules/@stdlib/_tools/changelog/generate/README.md

@@ -47,7 +47,10 @@ The function returns an object with the following properties:
 The function accepts the following `options`:
 
 -   **releaseType**: a release type for which to generate the changelog.
--   **format**: whether to generate a `grouped` changelog where commits are grouped by package or `aggregated` one.
+-   **format**: changelog format. Must be one of the following:
+
+    -   `'grouped'`: group commits by package.
+    -   `'aggregated'`: TODO:add description.
 -   **flags**: `git log` options used to retrieve commits from which to generate the changelog.
 
 By default, the changelog is generated for a non-release. To generate a changelog for an upcoming release, provide a valid release type:

lib/node_modules/@stdlib/_tools/changelog/parse-commits/README.md

@@ -44,7 +44,7 @@ The function accepts the following `options`:
 -   **dir**: directory for which to parse commits. May be either an absolute path or a path relative to the current working directory. Default: current working directory.
 -   **issueURL**: issue URL. Default: `https://github.com/stdlib-js/stdlib/issues/`.
 -   **prURL**: pull request URL. Default: `https://github.com/stdlib-js/stdlib/pull/`.
--   **flags**: options passed to invoked `git log` command to retrieve commit messages.
+-   **flags**: options passed to `git log` when retrieving commit messages.
 
 </section>
 

lib/node_modules/@stdlib/_tools/changelog/parse-commits/lib/commits.js

@@ -116,7 +116,7 @@ function extractCommits( dir, flags ) {
 	if ( flags ) {
 		flagNames = objectKeys( flags );
 		for ( i = 0; i < flagNames.length; i++ ) {
-			args.push( '--'+flagNames[i]+'='+flags[ flagNames[ i ] ] );
+			args.push( '--'+flagNames[ i ]+'='+flags[ flagNames[ i ] ] );
 		}
 	}
 	try {