single unversioned release notes section

Author: heskew

docusaurus.config.ts

@@ -59,51 +59,67 @@ const config: Config = {
 	onBrokenLinks: 'warn',
 	onBrokenMarkdownLinks: 'warn',
 
-	presets: [
+	plugins: [
+		// Main documentation
 		[
-			'@docusaurus/preset-classic',
+			'@docusaurus/plugin-content-docs',
 			{
-				docs: {
-					path: './docs',
-					sidebarPath: './sidebars.ts',
-					// Docs are served at the configured route base path
-					routeBasePath,
-					editUrl: ({ versionDocsDirPath, docPath }) => {
-						// For versioned docs: versionDocsDirPath is like 'versioned_docs/version-4.6'
-						// For current docs: versionDocsDirPath is 'docs'
-						if (versionDocsDirPath.startsWith('versioned_docs')) {
-							// Versioned docs are in versioned_docs/version-X.X/
-							return `https://github.com/HarperDB/documentation/blob/main/${versionDocsDirPath}/${docPath}`;
-						} else {
-							// Current docs are in the root docs/ directory
-							return `https://github.com/HarperDB/documentation/blob/main/docs/${docPath}`;
-						}
+				id: 'default',
+				path: './docs',
+				sidebarPath: './sidebars.ts',
+				routeBasePath,
+				editUrl: ({ versionDocsDirPath, docPath }) => {
+					// For versioned docs: versionDocsDirPath is like 'versioned_docs/version-4.6'
+					// For current docs: versionDocsDirPath is 'docs'
+					if (versionDocsDirPath.startsWith('versioned_docs')) {
+						// Versioned docs are in versioned_docs/version-X.X/
+						return `https://github.com/HarperDB/documentation/blob/main/${versionDocsDirPath}/${docPath}`;
+					} else {
+						// Current docs are in the root docs/ directory
+						return `https://github.com/HarperDB/documentation/blob/main/docs/${docPath}`;
+					}
+				},
+				lastVersion: '4.6',
+				includeCurrentVersion: false,
+				versions: {
+					'4.6': {
+						banner: 'none', // No banner for this version
 					},
-					lastVersion: '4.6',
-					includeCurrentVersion: false,
-					versions: {
-						'4.6': {
-							banner: 'none', // No banner for this version
-						},
-						'4.5': {
-							// No banner for 4.5 as its still actively maintained. Docusaurus doesn't allow us to set custom
-							// text for the banner. Only option is to eject swizzle DocVersionBanner (`npm run swizzle @docusaurus/theme-classic DocVersionBanner -- --eject`)
-							// and modify the internal rendering logic based on the version number. Cannot even add a new `banner` option without even more hackery.
-							// Here is a relevant discussion thread: https://github.com/facebook/docusaurus/discussions/7112 if we really want this, we should look to contribute this feature.
-							banner: 'none',
-						},
+					'4.5': {
+						// No banner for 4.5 as its still actively maintained
+						banner: 'none',
 					},
-					remarkPlugins: [[require('@docusaurus/remark-plugin-npm2yarn'), { sync: true }]],
 				},
-				blog: false,
-				theme: {
-					customCss: './src/css/custom.css',
+				remarkPlugins: [[require('@docusaurus/remark-plugin-npm2yarn'), { sync: true }]],
+			},
+		],
+		
+		// Release Notes documentation
+		[
+			'@docusaurus/plugin-content-docs',
+			{
+				id: 'release-notes',
+				path: 'release-notes',
+				routeBasePath: 'release-notes',
+				sidebarPath: './sidebarsReleaseNotes.ts',
+				editUrl: 'https://github.com/HarperDB/documentation/blob/main/',
+				// Reverse order and filter out index files from sidebar
+				async sidebarItemsGenerator({ defaultSidebarItemsGenerator, ...args }) {
+					const sidebarItems = await defaultSidebarItemsGenerator(args);
+					return sidebarItems.filter((i: any) => !i.id?.endsWith('/index')).reverse();
 				},
-			} satisfies Preset.Options,
+			},
 		],
-	],
-
-	plugins: [
+		
+		// Theme
+		[
+			'@docusaurus/theme-classic',
+			{
+				customCss: './src/css/custom.css',
+			},
+		],
+		
+		// Redirects
 		[
 			'@docusaurus/plugin-client-redirects',
 			{
@@ -137,7 +153,7 @@ const config: Config = {
 	},
 
 	themeConfig: {
-		// Replace with your project's social card
+		// Project's social card
 		image: 'img/HarperOpenGraph.png',
 		navbar: {
 			logo: {
@@ -153,6 +169,14 @@ const config: Config = {
 					position: 'left',
 					label: 'Documentation',
 				},
+				{
+					// Link directly to v4 (current version) instead of overview page
+					type: 'doc',
+					docsPluginId: 'release-notes',
+					docId: 'v4-tucker/index',
+					position: 'left',
+					label: 'Release Notes',
+				},
 				{
 					type: 'docsVersionDropdown',
 					position: 'right',

redirects.ts

@@ -6,8 +6,14 @@ type RedirectRule = {
 	from: string | string[];
 };
 
-// Function to generate redirects with the appropriate base path
-export function generateRedirects(basePath: string): RedirectRule[] {
+// Release notes redirects (not affected by base path)
+function generateReleaseNotesRedirects(): RedirectRule[] {
+	return [
+	];
+}
+
+// Documentation redirects
+function generateDocsRedirects(basePath: string): RedirectRule[] {
 	// Helper to add base path to a route
 	const withBase = (path: string) => {
 		// If basePath is just '/', return path as-is to avoid double slashes
@@ -143,6 +149,14 @@ export function generateRedirects(basePath: string): RedirectRule[] {
 	];
 }
 
+// Combine all redirects
+export function generateRedirects(basePath: string): RedirectRule[] {
+	return [
+		...generateReleaseNotesRedirects(),
+		...generateDocsRedirects(basePath),
+	];
+}
+
 // For backward compatibility, export a default set with empty base path
 export const redirects = generateRedirects('');