Configure documentation deployment

Author: mrlynn

.github/workflows/deploy-docs.yml

@@ -0,0 +1,44 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'mongodb-rag-docs/**'
+      - '.github/workflows/deploy-docs.yml'
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+          cache: npm
+          cache-dependency-path: mongodb-rag-docs/package-lock.json
+
+      - name: Install dependencies
+        working-directory: mongodb-rag-docs
+        run: npm ci
+
+      - name: Build website
+        working-directory: mongodb-rag-docs
+        run: npm run build
+
+      # Popular action to deploy to GitHub Pages:
+      # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          # Build output to publish to the `gh-pages` branch:
+          publish_dir: ./mongodb-rag-docs/build
+          # Assign commit authorship to the official GH-Actions bot for deploys to `gh-pages` branch:
+          user_name: github-actions[bot]
+          user_email: 41898282+github-actions[bot]@users.noreply.github.com

mongodb-rag-docs/docusaurus.config.js

@@ -0,0 +1,69 @@
+const config = {
+    title: 'MongoDB-RAG',
+    tagline: 'Retrieval-Augmented Generation with MongoDB',
+    url: 'https://mongodb-developer.github.io',
+    baseUrl: '/mongodb-rag/',
+    organizationName: 'mongodb-developer',
+    projectName: 'mongodb-rag',
+    trailingSlash: false,
+    
+    presets: [
+      [
+        '@docusaurus/preset-classic',
+        {
+          docs: {
+            sidebarPath: require.resolve('./sidebars.js'),
+            editUrl: 'https://github.com/mongodb-developer/mongodb-rag/tree/main/mongodb-rag-docs/',
+          },
+          theme: {
+            customCss: require.resolve('./src/css/custom.css'),
+          },
+        },
+      ],
+    ],
+  
+    themeConfig: {
+      navbar: {
+        title: 'MongoDB-RAG',
+        items: [
+          {
+            type: 'docSidebar',
+            sidebarId: 'docs',
+            position: 'left',
+            label: 'Docs',
+          },
+          {
+            href: 'https://github.com/mongodb-developer/mongodb-rag',
+            label: 'GitHub',
+            position: 'right',
+          },
+        ],
+      },
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Documentation',
+            items: [
+              {
+                label: 'Documentation',
+                to: '/docs/intro',
+              },
+            ],
+          },
+          {
+            title: 'More',
+            items: [
+              {
+                label: 'GitHub',
+                href: 'https://github.com/mongodb-developer/mongodb-rag',
+              },
+            ],
+          },
+        ],
+        copyright: `Copyright © ${new Date().getFullYear()} MongoDB. Built with Docusaurus.`,
+      },
+    },
+  };
+  
+  module.exports = config;