ENG-1406 - Fix shared docs routing and rename Discourse Graph page (#757)

* Refactor static parameter generation for documentation pages to use unique document mappings and improve directory handling in DocsPage component.

* Update links to "What is a discourse graph?" in navigation and documentation pages for consistency; remove outdated shared page.

Author: mdroidian

apps/website/app/(docs)/docs/obsidian/[slug]/page.tsx

@@ -16,7 +16,7 @@ const Page = async ({ params }: { params: Promise<{ slug: string }> }) => {
 export default Page;
 
 export const generateStaticParams = () =>
-  generateDocsStaticParams(docMap.default);
+  generateDocsStaticParams([...new Set(Object.values(docMap))]);
 
 export const generateMetadata = async ({
   params,

apps/website/app/(docs)/docs/obsidian/navigation.ts

@@ -15,7 +15,7 @@ export const navigation: NavigationList = [
     links: [
       {
         title: "What is a discourse graph?",
-        href: `${ROOT}/what-is-discourse-graph`,
+        href: `${ROOT}/what-is-a-discourse-graph`,
       },
       {
         title: "Grammar",

apps/website/app/(docs)/docs/obsidian/pages/getting-started.md

@@ -5,7 +5,7 @@ author: ""
 published: true
 ---
 
-The Discourse Graph plugin enables [Obsidian](https://obsidian.md/) users to seamlessly add additional semantic structure to their notes, including specified page types and link types that [model scientific discourse](/docs/roam/what-is-discourse-graph), to enable more complex and structured knowledge synthesis work, such as a complex interdisciplinary literature review, and enhanced collaboration with others on this work.
+The Discourse Graph plugin enables [Obsidian](https://obsidian.md/) users to seamlessly add additional semantic structure to their notes, including specified page types and link types that [model scientific discourse](/docs/obsidian/what-is-a-discourse-graph), to enable more complex and structured knowledge synthesis work, such as a complex interdisciplinary literature review, and enhanced collaboration with others on this work.
 
 For more information about Discourse Graphs, check out our website at [https://discoursegraphs.com](https://discoursegraphs.com)
 
@@ -19,7 +19,7 @@ For more information about Discourse Graphs, check out our website at [https://d
 
 ## What's Next?
 
-- Learn about [what makes a discourse graph](./what-is-discourse-graph)
+- Learn about [what makes a discourse graph](./what-is-a-discourse-graph)
 - Explore [use cases](./literature-reviewing) for discourse graphs
 - Join our community to share your experience and get help
 
@@ -37,6 +37,6 @@ Follow our handy guides to get started on the basics as quickly as possible:
 
 Learn the fundamentals of the Discourse Graph plugin to get a deeper understanding of our main features:
 
-- [What is a Discourse Graph?](./what-is-discourse-graph)
+- [What is a Discourse Graph?](./what-is-a-discourse-graph)
 - [The Discourse Graph plugin grammar](./grammar)
 - [The Base Grammar: questions, claims, and evidence](./base-grammar)

apps/website/app/(docs)/docs/roam/[slug]/page.tsx

@@ -22,7 +22,7 @@ const Page = async ({ params }: Params) => {
 export default Page;
 
 export const generateStaticParams = () =>
-  generateDocsStaticParams(docMap.default);
+  generateDocsStaticParams([...new Set(Object.values(docMap))]);
 
 export const generateMetadata = async ({
   params,

apps/website/app/(docs)/docs/roam/navigation.ts

@@ -48,7 +48,7 @@ export const navigation: NavigationList = [
     links: [
       {
         title: "What is a discourse graph?",
-        href: `${ROOT}/what-is-discourse-graph`,
+        href: `${ROOT}/what-is-a-discourse-graph`,
       },
       {
         title: "Grammar",

apps/website/app/(docs)/docs/roam/pages/getting-started.md

@@ -5,7 +5,7 @@ author: ""
 published: true
 ---
 
-The Discourse Graph extension enables [Roam](https://roamresearch.com/) users to seamlessly add additional semantic structure to their notes, including specified page types and link types that [model scientific discourse](./what-is-discourse-graph), to enable more complex and structured [knowledge synthesis work](https://oasislab.pubpub.org/pub/54t0y9mk/release/3), such as a complex interdisciplinary literature review, and enhanced collaboration with others on this work.
+The Discourse Graph extension enables [Roam](https://roamresearch.com/) users to seamlessly add additional semantic structure to their notes, including specified page types and link types that [model scientific discourse](./what-is-a-discourse-graph), to enable more complex and structured [knowledge synthesis work](https://oasislab.pubpub.org/pub/54t0y9mk/release/3), such as a complex interdisciplinary literature review, and enhanced collaboration with others on this work.
 
 ## Overview
 
@@ -27,6 +27,6 @@ Follow our handy guides to get started on the basics as quickly as possible:
 
 Learn the fundamentals of the Discourse Graph extension to get a deeper understanding of our main features:
 
-- [What is a Discourse Graph?](./what-is-discourse-graph)
+- [What is a Discourse Graph?](./what-is-a-discourse-graph)
 - [The Discourse Graph extension grammar](./grammar)
 - [The base grammar: questions, claims, and evidence](./base-grammar)

apps/website/app/(docs)/docs/shared/docMap.ts

@@ -1,9 +1,10 @@
+/* eslint-disable @typescript-eslint/naming-convention */
 // Shared paths
 export const SHARED_DOCS = "app/(docs)/docs/sharedPages";
 
 // Shared document mappings
 export const sharedDocMap = {
-  "what-is-discourse-graph": SHARED_DOCS,
+  "what-is-a-discourse-graph": SHARED_DOCS,
   "base-grammar": SHARED_DOCS,
   "literature-reviewing": SHARED_DOCS,
   "research-roadmapping": SHARED_DOCS,
@@ -15,4 +16,4 @@ export const sharedDocMap = {
 export type DocMapType = {
   default: string;
   [key: string]: string;
-}; 
+};

…s/sharedPages/what-is-discourse-graph.md …sharedPages/what-is-a-discourse-graph.mdapps/website/app/(docs)/docs/sharedPages/what-is-discourse-graph.md renamed to apps/website/app/(docs)/docs/sharedPages/what-is-a-discourse-graph.md apps/website/app/(docs)/docs/sharedPages/what-is-discourse-graph.md renamed to apps/website/app/(docs)/docs/sharedPages/what-is-a-discourse-graph.md

@@ -1,13 +1,13 @@
 ---
-title: "What is Discourse Graph"
+title: "What is a Discourse Graph"
 date: "2025-01-01"
 author: ""
 published: true
 ---
 
-**Discourse graphs** are an information model for bodies of knowledge that emphasize discourse moves (such as questions, claims, and evidence), and relations (such as support or opposition), rather than papers or sources as the main units.
+**Discourse Graphs** are an information model for bodies of knowledge that emphasize discourse moves (such as questions, claims, and evidence), and relations (such as support or opposition), rather than papers or sources as the main units.
 
-To give an intuition for what it is, here is a figure of a visual representation of a simple discourse graph for a body of literature on bans and antisocial behavior in online forums. You may recognize similarities to things like argument maps.
+To give an intuition for what it is, here is a figure of a visual representation of a simple Discourse Graph for a body of literature on bans and antisocial behavior in online forums. You may recognize similarities to things like argument maps.
 
 ![](/docs/roam/argument-map.png)
 
@@ -17,4 +17,4 @@ Consider how that information model foregrounds the conceptual building blocks a
 
 This information model (theoretically!) has high potential for augmenting individual and collective "research-grade" synthesis (e.g., lit reviews for a dissertation or grant proposal).
 
-Discourse graphs are not a new idea (you can read more about it in [this short (academic-focused) write-up](http://joelchan.me/assets/pdf/Discourse_Graphs_for_Augmented_Knowledge_Synthesis_What_and_Why.pdf) or this more [practically-oriented article](https://oasislab.pubpub.org/pub/54t0y9mk/release/3)), but the potential to use it for everyday research work is!
+Discourse Graphs are not a new idea (you can read more about it in [this short (academic-focused) write-up](http://joelchan.me/assets/pdf/Discourse_Graphs_for_Augmented_Knowledge_Synthesis_What_and_Why.pdf) or this more [practically-oriented article](https://oasislab.pubpub.org/pub/54t0y9mk/release/3)), but the potential to use it for everyday research work is!

apps/website/app/components/DocsPage.tsx

@@ -51,36 +51,45 @@ export const DocsPage = async ({ params, directory }: DocsPageProps) => {
   }
 };
 
-export const generateDocsStaticParams = async (directory: string) => {
-  try {
-    const directoryExists = await fs
-      .stat(directory)
-      .then((stats) => stats.isDirectory())
-      .catch(() => false);
+const generateParamsForDirectory = async (directory: string) => {
+  const directoryExists = await fs
+    .stat(directory)
+    .then((stats) => stats.isDirectory())
+    .catch(() => false);
 
-    if (!directoryExists) {
-      console.log("No docs directory found");
-      return [];
-    }
+  if (!directoryExists) {
+    console.log("No docs directory found");
+    return [];
+  }
 
-    const files = await fs.readdir(directory);
-    const mdFiles = files.filter((filename) => filename.endsWith(".md"));
+  const files = await fs.readdir(directory);
+  const mdFiles = files.filter((filename) => filename.endsWith(".md"));
 
-    const publishedFiles = await Promise.all(
-      mdFiles.map(async (filename) => {
-        const { published } = await getFileMetadata({
-          filename,
-          directory,
-        });
-        return { filename, published };
-      }),
-    );
+  const publishedFiles = await Promise.all(
+    mdFiles.map(async (filename) => {
+      const { published } = await getFileMetadata({
+        filename,
+        directory,
+      });
+      return { filename, published };
+    }),
+  );
 
-    return publishedFiles
-      .filter(({ published }) => published)
-      .map(({ filename }) => ({
-        slug: filename.replace(/\.md$/, ""),
-      }));
+  return publishedFiles
+    .filter(({ published }) => published)
+    .map(({ filename }) => ({ slug: filename.replace(/\.md$/, "") }));
+};
+
+export const generateDocsStaticParams = async (
+  directories: string | string[],
+) => {
+  try {
+    const dirs =
+      typeof directories === "string" ? [directories] : [...directories];
+    const results = await Promise.all(
+      dirs.map((dir) => generateParamsForDirectory(dir)),
+    );
+    return results.flat();
   } catch (error) {
     console.error("Error generating static params:", error);
     return [];