docs[minor]: Add new QA & RAG use case section

.gitignore

@@ -42,4 +42,5 @@ langchain/api_refs_docs_build/dist/**/*
 
 .docusaurus/
 docs/build/
-docs/api_refs/typedoc.json
+docs/api_refs/typedoc.json
+docs/core_docs/**/*.md

CONTRIBUTING.md

@@ -266,6 +266,32 @@ and in generated documentation.
 
 ### Contribute Documentation
 
+#### Install dependencies
+
+##### Note: you only need to follow these steps if you are building the docs site locally.
+
+1. [Quarto](https://quarto.org/) - package that converts Jupyter notebooks (`.ipynb` files) into `.mdx` files for serving in Docusaurus.
+2. `yarn build --filter=core_docs` - It's as simple as that! (or you can simply run `yarn build` from `docs/core_docs/`)
+
+All notebooks are converted to `.md` files and automatically gitignored. If you would like to create a non notebook doc, it must be a `.mdx` file.
+
+### Writing Notebooks
+
+When adding new dependencies inside the notebook you must update the import map inside `deno.json` in the root of the LangChain repo.
+
+This is required because the notebooks use the Deno runtime, and Deno formats imports differently than Node.js.
+
+Example:
+
+```typescript
+// Import in Node:
+import { z } from "zod";
+// Import in Deno:
+import { z } from "npm:/zod";
+```
+
+See examples inside `deno.json` for more details.
+
 Docs are largely autogenerated by [TypeDoc](https://typedoc.org/) from the code.
 
 For that reason, we ask that you add good documentation to all classes and methods.

deno.json

@@ -0,0 +1,14 @@
+{
+  "imports": {
+    "langchain/": "npm:/langchain/",
+    "@langchain/community/": "npm:/@langchain/community/",
+    "@langchain/openai": "npm:@langchain/openai",
+    "@langchain/core/": "npm:/@langchain/core/",
+    "cheerio": "npm:/cheerio",
+    "@langchain/pinecone": "npm:@langchain/pinecone",
+    "@pinecone-database/pinecone": "npm:@pinecone-database/pinecone",
+    "zod": "npm:/zod",
+    "@langchain/anthropic": "npm:@langchain/anthropic",
+    "node-llama-cpp": "npm:/node-llama-cpp"
+  }
+}

docs/core_docs/.gitignore

@@ -29,3 +29,5 @@ yarn-error.log*
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
+
+/.quarto/

docs/core_docs/docs/get_started/introduction.mdx

@@ -80,7 +80,7 @@ Let models choose which tools to use given high-level directives
 Walkthroughs and techniques for common end-to-end use cases, like:
 
 - [Document question answering](/docs/use_cases/question_answering/)
-- [RAG](/docs/use_cases/rag/code_understanding)
+- [RAG](/docs/use_cases/question_answering/)
 - [Agents](/docs/use_cases/autonomous_agents/)
 - and much more...
 

docs/core_docs/docs/use_cases/rag/code_understanding.mdx → docs/core_docs/docs/use_cases/code_understanding.mdx

@@ -1,4 +1,4 @@
-# RAG over code
+# Code Understanding
 
 ## Use case
 

docs/core_docs/docs/use_cases/question_answering/_category_.yml

@@ -1,2 +1,2 @@
-label: 'QA and Chat over Documents'
+label: 'Q&A with RAG'
 position: 3