Merge branch 'main' of https://github.com/stanfordnlp/dspy

Author: okhat

README.md

@@ -13,13 +13,9 @@
 
 ----
 
-DSPy is the open-source framework for **building high-quality, modular AI systems** by _programming—rather than prompting—language models_. It provides abstractions and algorithms for **optimizing the prompts and weights** in LM programs, ranging from simple classifiers to sophisticated RAG pipelines and Agent loops.
-
-Instead of writing brittle LM-specific prompts, you write compositional code and use DSPy optimizers to teach different models like `GPT-4o` or `Llama-3.2` to **deliver higher quality outputs** or avoid specific failure patterns. In essence, DSPy optimizers then _compile your high-level code_ into low-level computations, prompts, or weight updates that **align your LM with your program’s structure and metrics**.
-
-
-DSPy stands for Declarative Self-improving Python. This [recent lecture](https://www.youtube.com/watch?v=JEMYuzrKLUw) is a good conceptual introduction. Our [Discord server](https://discord.gg/XCGy2WDCQB) is a great place to meet the community, seek help, or start contributing.
+DSPy is the open-source framework for _programming—rather than prompting—language models_. It allows you to iterate fast on **building modular AI systems** and provides algorithms for **optimizing their prompts and weights**, whether you're building simple classifiers, sophisticated RAG pipelines, or Agent loops.
 
+DSPy stands for Declarative Self-improving Python. Instead of brittle prompts, you write compositional _Python code_ and use DSPy's tools to **teach your LM to deliver high-quality outputs**. This [lecture](https://www.youtube.com/watch?v=JEMYuzrKLUw) is a good conceptual introduction. Meet the community, seek help, or start contributing via our GitHub repo here and our [Discord server](https://discord.gg/XCGy2WDCQB).
 
 
 ## Documentation: [dspy.ai](https://dspy.ai)

docs/README.md

@@ -1,6 +1,6 @@
 # DSPy Documentation
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+This website is built using [Material for MKDocs](https://squidfunk.github.io/mkdocs-material/), a Material UI inspired theme for MKDocs.
 
 ## Building docs locally
 
@@ -13,21 +13,27 @@ To build and test the documentation locally:
 
 2. Install the necessary dependencies:
    ```bash
-   npm install
+   pip install -r requirements.txt
    ```
 
 3. Run the build command:
    ```bash
-   npm run build
+   mkdocs build
    ```
 
-This will generate a static build of the documentation site in the `build` directory. You can then serve this directory to view the site locally. If you see the build failing make sure to fix it before pushing.
+This will generate a static build of the documentation site in the `site` directory. You can then serve this directory to view the site locally using:
+
+```bash
+mkdocs serve
+```
+
+If you see the build failing make sure to fix it before pushing.
 
 ## Continuous Integration (CI) Build Checks
 
 We have automated build checks set up in our CI pipeline to ensure the documentation builds successfully before merging changes. These checks:
 
-1. Run the `npm run build` command
+1. Run the `mkdocs build` command
 2. Verify that the build completes without errors
 3. Help catch potential issues early in the development process
 

docs/docs/blog/index.md

@@ -102,7 +102,7 @@ plugins:
   - social
   - search
   - mkdocstrings
-  - blog
+  # - blog
   - mkdocs-jupyter:
       ignore_h1_titles: True
   - redirects: