docs: update Llama Deploy documentation build

.readthedocs.yaml

@@ -10,12 +10,12 @@ build:
   tools:
     python: "3.12"
   jobs:
+    post_create_environment:
+      - python -m pip install poetry
+    post_install:
+      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH cd docs && poetry install
     pre_build:
-      - python docs/merge_llama_deploy_docs.py
+      - cd docs && poetry run merge-llama-deploy-docs
 
 mkdocs:
   configuration: docs/mkdocs.yml
-
-python:
-  install:
-    - requirements: docs/requirements.txt

docs/.gitignore

@@ -0,0 +1,4 @@
+# docs build
+docs/api_reference/llama_deploy/*
+docs/module_guides/llama_deploy/*
+llama_deploy

docs/README.md

@@ -0,0 +1,56 @@
+# Documentation
+
+This directory contains the documentation source code for LlamaIndex, available at https://docs.llamaindex.ai.
+
+This guide is made for anyone who's interested in running LlamaIndex documentation locally,
+making changes to it and making contributions. LlamaIndex is made by the thriving community
+behind it, and you're always welcome to make contributions to the project and the
+documentation.
+
+## Build Docs
+
+If you haven't already, clone the LlamaIndex Github repo to a local directory:
+
+```
+git clone https://github.com/run-llama/llama_index.git && cd llama_index
+```
+
+Documentation has its own, dedicated Python virtual environment, and all the tools and scripts are available from the
+`docs` directory:
+
+```
+cd llama_index/docs
+```
+
+From now on, we assume all the commands will be executed from the `docs` directory.
+
+Install all dependencies required for building docs (mainly `mkdocs` and its extension):
+
+- [Install poetry](https://python-poetry.org/docs/#installation) - this will help you manage package dependencies
+- `poetry install` - this will install all dependencies needed for building docs
+
+To build the docs and browse them locally run:
+
+```
+poetry run serve
+```
+
+During the build, notebooks are converted to documentation pages, and this takes several minutes. If you're not
+working on the "Examples" section of the documentation, you can run the same command with `--skip-notebooks`:
+
+```
+poetry run serve --skip-notebooks
+```
+
+> [!IMPORTANT]
+> Building the documentation takes a while, so make sure you see the following output before opening the browser:
+>
+> ```
+> ...
+> INFO    -  Documentation built in 53.32 seconds
+> INFO    -  [16:18:17] Watching paths for changes: 'docs'
+> INFO    -  [16:18:17] Serving on http://127.0.0.1:8000/en/stable/
+> ```
+
+You can now open your browser at http://localhost:8000/ to view the generated docs. The local server will rebuild the
+docs and refresh your browser every time you make changes to the docs.

docs/docs/api_reference/llama_deploy/README.txt

@@ -0,0 +1,2 @@
+Documentation content will be pulled from https://github.com/run-llama/llama_deploy,
+make sure to run `python docs/merge_llama_deploy_docs.py` before building docs.

docs/docs/module_guides/llama_deploy/README.txt

@@ -0,0 +1,2 @@
+Documentation content will be pulled from https://github.com/run-llama/llama_deploy,
+make sure to run `python docs/merge_llama_deploy_docs.py` before building docs.