feedback

scripts/commands/convertApiDocsToHistorical.ts

@@ -103,9 +103,14 @@ async function copyApiDocsAndUpdateLinks(
     );
   }
 
-  const source = `${getRoot()}/docs/api/${pkgName}/release-notes/${versionWithoutPatch}.md`;
-  if (await pathExists(source)) {
-    updateLinksFile(pkgName, versionWithoutPatch, source, source);
+  const releaseNotePath = `${getRoot()}/docs/api/${pkgName}/release-notes/${versionWithoutPatch}.md`;
+  if (await pathExists(releaseNotePath)) {
+    updateLinksFile(
+      pkgName,
+      versionWithoutPatch,
+      releaseNotePath,
+      releaseNotePath,
+    );
   }
 }
 

scripts/commands/updateApiDocs.ts

@@ -39,7 +39,7 @@ import {
   addNewReleaseNotes,
   generateReleaseNotesIndex,
   updateHistoricalTocFiles,
-  writeSeparateReleaseNotes,
+  writeReleaseNoteForVersion,
 } from "../lib/api/releaseNotes";
 
 interface Arguments {
@@ -243,7 +243,7 @@ async function convertHtmlToMarkdown(
           : `${baseUrl}/${link}`,
       );
 
-      await writeSeparateReleaseNotes(pkg, result.markdown);
+      await writeReleaseNoteForVersion(pkg, result.markdown);
       continue;
     }
 

scripts/lib/api/releaseNotes.ts

@@ -145,10 +145,10 @@ function addNewReleaseNoteToc(releaseNotesNode: any, newVersion: string) {
 }
 
 /**
- * Updates the release notes folder by adding the notes to their corresponding version
- * file.
+ * Creates the release note file for the minor version found in `pkg`.If the file
+ * already exists, it will keep the initial header and overwrite the rest of the content.
  */
-export async function writeSeparateReleaseNotes(
+export async function writeReleaseNoteForVersion(
   pkg: Pkg,
   releaseNoteMarkdown: string,
 ): Promise<void> {