docs: updating according to layout/naming

Author: canerakdas

apps/site/components/Downloads/MinorReleasesTable/index.tsx

@@ -27,6 +27,8 @@ export const MinorReleasesTable: FC<MinorReleasesTableProps> = ({
   releases,
 }) => {
   const t = useTranslations('components.minorReleasesTable');
+  // Chunk minor releases into groups of 8 for scrollable display.
+  // This is to ensure that the table does not become too wide and remains user-friendly
   const releaseGroups = chunkedReleases(releases, 8);
 
   return (

apps/site/components/withDownloadArchive.tsx

@@ -15,7 +15,8 @@ type WithDownloadArchiveProps = {
 };
 
 /**
- * Provides download artifacts and sidebar items to its child component
+ * Higher-order component that extracts version from pathname,
+ * fetches release data, and provides download artifacts to child component
  */
 const WithDownloadArchive: FC<WithDownloadArchiveProps> = async ({
   children: Component,
@@ -26,10 +27,11 @@ const WithDownloadArchive: FC<WithDownloadArchiveProps> = async ({
   // Extract version from pathname
   const version = extractVersionFromPath(pathname);
 
-  if (!version) {
+  if (version == null) {
     return null;
   }
 
+  // Find the release data for the given version
   const release = findReleaseByVersion(releaseData, version);
 
   if (!release) {

apps/site/next.dynamic.constants.mjs

@@ -20,7 +20,7 @@ export const IGNORED_ROUTES = [
     locale !== defaultLocale.code && /^blog/.test(pathname),
   // This is used to ignore all pathnames that are empty
   ({ locale, pathname }) => locale.length && !pathname.length,
-  // This is used to ignore download routes for major versions and downloads archive page
+  // This is used to ignore download routes for Node.js versions and downloads archive page
   ({ pathname }) => /^download\/(v\d+(\.\d+)*|archive)$/.test(pathname),
 ];
 

apps/site/util/downloadUtils/archive.tsx

@@ -88,6 +88,10 @@ const getCompatibleArtifacts = ({
   });
 };
 
+/**
+ * Builds the release artifacts for a given Node.js release and version.
+ * It retrieves binaries, installers, and source files based on the version.
+ */
 export const buildReleaseArtifacts = (
   release: NodeRelease,
   version: string