Initial MKDocs (#285)

docs/mkdocs.yml

@@ -0,0 +1,197 @@
+site_name: LangGraph
+site_description: Build language agents as graphs
+site_url: https://langchain-ai.github.io/langgraph/
+theme:
+  name: material
+  custom_dir: overrides
+  logo: static/img/brand/wordmark.png
+  favicon: static/img/brand/favicon.png
+  features:
+    - announce.dismiss
+    - content.action.edit
+    - content.action.view
+    - content.code.annotate
+    - content.code.copy
+    - content.code.select
+    - content.tabs.link
+    - content.tooltips
+    - header.autohide
+    - navigation.expand
+    - navigation.footer
+    - navigation.indexes
+    - navigation.instant
+    - navigation.instant.prefetch
+    - navigation.instant.progress
+    - navigation.prune
+    - navigation.sections
+    - navigation.tabs
+    - navigation.top
+    - navigation.tracking
+    - search.highlight
+    - search.share
+    - search.suggest
+    - toc.follow
+  palette:
+  - scheme: default
+    primary: white
+    accent: gray
+    toggle:
+      icon: material/brightness-7
+      name: Switch to dark mode
+  - scheme: slate
+    primary: grey
+    accent: white
+    toggle:
+      icon: material/brightness-4
+      name: Switch to light mode
+  font:
+    text: "Public Sans"
+    code: "Roboto Mono"
+plugins:
+  - search:
+      separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
+  - autorefs
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            members_order: source 
+            allow_inspection: true
+            show_bases: true
+  - mkdocs-jupyter:
+      ignore_h1_titles: true
+      execute: false
+      include_source: True
+      include_requirejs: true
+  # TODO: Add minify plugin once it works alright with code block copying
+  # - minify:
+  #     minify_html: true
+nav:
+  - Home: 
+      - 'index.md'
+      - Quick Start: quick_start.ipynb
+  - Concepts:
+      - 'concepts.md'
+  - "How-to Guides":
+      - Basics:
+          - State Management: how-tos/state-model.ipynb
+          - Tool Integration: how-tos/sql_example.ipynb
+          - Human-in-the-Loop: how-tos/human-in-the-loop.ipynb
+      - Performance:  
+          - Async Execution: how-tos/async.ipynb
+          - Streaming Responses: how-tos/streaming-tokens.ipynb
+      - Graph Structure:
+          - Subgraphs: how-tos/subgraph.ipynb 
+          - Branching: how-tos/branching.ipynb
+      - Development:
+          - Persistence: how-tos/persistence.ipynb
+          - Visualization: how-tos/visualization.ipynb 
+          - Time Travel: how-tos/time-travel.ipynb
+          - Benchmarking: how-tos/swe-bench.ipynb
+  - Tutorials:
+      - Agent Executors:
+          - Chat Agent (Function Calling):
+              - Base: tutorials/chat_agent_executor_with_function_calling/base.ipynb
+              - High-Level: tutorials/chat_agent_executor_with_function_calling/high-level.ipynb
+              - High-Level Tools: tutorials/chat_agent_executor_with_function_calling/high-level-tools.ipynb
+              - Modifications:
+                  - Human-in-the-Loop: tutorials/chat_agent_executor_with_function_calling/human-in-the-loop.ipynb
+                  - Force Tool First: tutorials/chat_agent_executor_with_function_calling/force-calling-a-tool-first.ipynb
+                  - Respond in Format: tutorials/chat_agent_executor_with_function_calling/respond-in-format.ipynb 
+                  - Dynamic Direct Return: tutorials/chat_agent_executor_with_function_calling/dynamically-returning-directly.ipynb
+                  - Manage Agent Steps: tutorials/chat_agent_executor_with_function_calling/managing-agent-steps.ipynb
+          - Langchain Agent:
+              - Base: tutorials/agent_executor/base.ipynb
+              - High-Level: tutorials/agent_executor/high-level.ipynb  
+              - Modifications:
+                  - Human-in-the-Loop: tutorials/agent_executor/human-in-the-loop.ipynb
+                  - Force Tool First: tutorials/agent_executor/force-calling-a-tool-first.ipynb
+                  - Manage Agent Steps: tutorials/agent_executor/managing-agent-steps.ipynb
+      - Planning Agents:  
+          - Plan-and-Execute: tutorials/plan-and-execute/plan-and-execute.ipynb
+          - Reasoning w/o Observation: tutorials/rewoo/rewoo.ipynb 
+          - LLMCompiler: tutorials/llm-compiler/LLMCompiler.ipynb
+      - Reflection & Critique:
+          - Basic Reflection: tutorials/reflection/reflection.ipynb
+          - Reflexion: tutorials/reflexion/reflexion.ipynb
+          - Language Agent Tree Search: tutorials/lats/lats.ipynb
+      - Multi-Agent Systems:
+          - Collaboration: tutorials/multi_agent/multi-agent-collaboration.ipynb  
+          - Supervision: tutorials/multi_agent/agent_supervisor.ipynb
+          - Hierarchical Teams: tutorials/multi_agent/hierarchical_agent_teams.ipynb
+      - Research & QA:   
+          - Web Research (STORM): tutorials/storm/storm.ipynb
+          - Retrieval-Augmented Generation:
+              - tutorials/rag/langgraph_adaptive_rag.ipynb
+              - tutorials/rag/langgraph_adaptive_rag_cohere.ipynb
+              - tutorials/rag/langgraph_adaptive_rag_local.ipynb
+              - tutorials/rag/langgraph_agentic_rag.ipynb 
+              - tutorials/rag/langgraph_crag.ipynb
+              - tutorials/rag/langgraph_crag_local.ipynb
+              - tutorials/rag/langgraph_self_rag.ipynb  
+              - tutorials/rag/langgraph_self_rag_local.ipynb
+      - Applications:
+          - Chatbots: 
+              - Customer Support: tutorials/chatbots/customer-support.ipynb
+              - Info Gathering: tutorials/chatbots/information-gather-prompting.ipynb
+          - Code Assistant: tutorials/code_assistant/langgraph_code_assistant.ipynb  
+          - Web Navigation: tutorials/web-navigation/web_voyager.ipynb
+      - Evaluation & Analysis:  
+          - Chatbot Eval via Sim:
+              - Agent-based: tutorials/chatbot-simulation-evaluation/agent-simulation-evaluation.ipynb
+              - Dataset-based: tutorials/chatbot-simulation-evaluation/langsmith-agent-simulation-evaluation.ipynb  
+          - Self-Discovering Agent: tutorials/self-discover/self-discover.ipynb
+          - Swarm: tutorials/gptswarm/swarm.ipynb
+  - Reference:
+      - Graphs: reference/graphs.md
+      - Checkpointing: reference/checkpoints.md
+      - Prebuilt Components: reference/prebuilt_components.md
+  
+
+markdown_extensions:
+  - abbr
+  - admonition
+  - pymdownx.details
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - toc:
+      permalink: true
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink:
+      normalize_issue_symbols: true
+      repo_url_shorthand: true
+      user: langchain-ai 
+      repo: langgraph
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.snippets:
+      auto_append:
+        - includes/mkdocs.md
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+      combine_header_slug: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+extra_css:
+  - css/mkdocstrings.css