From 9e631e1dd44d1abb14fa65772c5da4100ff5ab18 Mon Sep 17 00:00:00 2001 From: mongodben <90647379+mongodben@users.noreply.github.com> Date: Fri, 1 Dec 2023 14:54:18 -0500 Subject: [PATCH 1/2] add WIP disclaimers + sidebar update --- docs/docs/index.md | 13 ++++++++++ docs/docusaurus.config.ts | 5 ++++ docs/sidebars.ts | 52 +++++++++++++++++++++++++-------------- 3 files changed, 52 insertions(+), 18 deletions(-) diff --git a/docs/docs/index.md b/docs/docs/index.md index aa140dbfe..08798a0a6 100644 --- a/docs/docs/index.md +++ b/docs/docs/index.md @@ -1,5 +1,18 @@ +--- +title: Home +--- + # MongoDB RAG Framework +:::warning[👷‍♂️ Work In Progress 👷‍♂️] + +The MongoDB RAG Framework is under active development +and may undergo breaking changes. + +We aim to keep the documentation up to date with the latest changes. + +::: + Build full stack retrieval augmented generation (RAG) applications using MongoDB and [Atlas Vector Search](https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-overview/). diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts index f121a6bab..a8c189a83 100644 --- a/docs/docusaurus.config.ts +++ b/docs/docusaurus.config.ts @@ -109,6 +109,11 @@ const config: Config = { theme: prismThemes.github, darkTheme: prismThemes.dracula, }, + announcementBar: { + content: + "⚠️ The MongoDB RAG Framework is under active development and may undergo breaking changes. ⚠️", + backgroundColor: "#FFF8E6", + }, } satisfies Preset.ThemeConfig, }; diff --git a/docs/sidebars.ts b/docs/sidebars.ts index f7ab7cffc..1553fdb5d 100644 --- a/docs/sidebars.ts +++ b/docs/sidebars.ts @@ -1,4 +1,4 @@ -import type {SidebarsConfig} from '@docusaurus/plugin-content-docs'; +import type { SidebarsConfig } from "@docusaurus/plugin-content-docs"; /** * Creating a sidebar enables you to: @@ -12,23 +12,39 @@ import type {SidebarsConfig} from '@docusaurus/plugin-content-docs'; */ const sidebars: SidebarsConfig = { // By default, Docusaurus generates a sidebar from the docs folder structure - main: ["index", "quick-start", "mongodb",{ - type: 'category', - label: 'Data Ingest CLI', - collapsible: false, - collapsed: false, - items: ["ingest/configure", "ingest/configuration-reference","ingest/command-reference", "ingest/data-sources", "ingest/fine-tune"] - }, { - type: 'category', - label: 'Chat Server', - collapsible: false, - collapsed: false, - items: ["server/configure", { - type: "link", - label: "OpenAPI Spec", - href: "/server/openapi", - }] - }, "ui"], + main: [ + "index", + "quick-start", + "mongodb", + { + type: "category", + label: "Data Ingest CLI", + collapsible: false, + collapsed: false, + items: [ + "ingest/configure", + "ingest/configuration-reference", + "ingest/command-reference", + "ingest/data-sources", + "ingest/fine-tune", + ], + }, + { + type: "category", + label: "Chat Server", + collapsible: false, + collapsed: false, + items: [ + "server/configure", + { + type: "link", + label: "OpenAPI Spec", + href: "/server/openapi", + }, + ], + }, + "ui", + ], }; export default sidebars; From 3ce99faf958fe1b6efe14a7a5b36a0f4a3803fae Mon Sep 17 00:00:00 2001 From: Ben Perlmutter <90647379+mongodben@users.noreply.github.com> Date: Mon, 4 Dec 2023 14:42:38 -0500 Subject: [PATCH 2/2] Update docs/docs/index.md Co-authored-by: Nick Larew --- docs/docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/index.md b/docs/docs/index.md index 08798a0a6..e4f429aa2 100644 --- a/docs/docs/index.md +++ b/docs/docs/index.md @@ -9,7 +9,7 @@ title: Home The MongoDB RAG Framework is under active development and may undergo breaking changes. -We aim to keep the documentation up to date with the latest changes. +We aim to keep the documentation up to date with the latest version. :::