[PR #10732] docs: add comprehensive documentation structure and guides for Ollama #13347

Open
opened 2026-04-13 00:24:31 -05:00 by GiteaMirror · 0 comments
Owner

Original Pull Request: https://github.com/ollama/ollama/pull/10732

State: open
Merged: No


As discussed in #10370, this pull request introduces an actual build for the documentation system for the project. Ideally, this can be added to Readthedocs (I would either need rights in the organization or someone else should do that, the config file is also in the PR).
There are surely improvements

The docs can be run using make html inside the docs folder. I would suggest to add a link to the main website and/or on Github (README), once the RTD build is up.

Documentation Build System

  • Added a Sphinx configuration file (docs/conf.py) and the whole setup (Makefile etc) to build the docs.

Documentation Updates

  • Reorganized the documentation structure, including renaming and moving files (e.g., docs/api.md renamed to docs/devs/api.md) and updating links in the README.md to reflect the new structure.
  • Updated the main documentation README.md to include instructions for building and contributing to the documentation.

Continuous Integration Enhancements

  • Added a new docs job to the GitHub Actions workflow (.github/workflows/test.yaml) for testing the documentation build process on Ubuntu with Python 3.10.
  • Added a .readthedocs.yaml configuration file to integrate with Read the Docs. This will need to activate the builds there.
**Original Pull Request:** https://github.com/ollama/ollama/pull/10732 **State:** open **Merged:** No --- As discussed in #10370, this pull request introduces an actual build for the documentation system for the project. Ideally, this can be added to Readthedocs (I would either need rights in the organization or someone else should do that, the config file is also in the PR). There are surely improvements The docs can be run using `make html` inside the docs folder. I would suggest to add a link to the main website and/or on Github (README), once the RTD build is up. ### Documentation Build System * Added a Sphinx configuration file (`docs/conf.py`) and the whole setup (Makefile etc) to build the docs. ### Documentation Updates * Reorganized the documentation structure, including renaming and moving files (e.g., `docs/api.md` renamed to `docs/devs/api.md`) and updating links in the `README.md` to reflect the new structure. * Updated the main documentation `README.md` to include instructions for building and contributing to the documentation. ### Continuous Integration Enhancements * Added a new `docs` job to the GitHub Actions workflow (`.github/workflows/test.yaml`) for testing the documentation build process on Ubuntu with Python 3.10. * Added a `.readthedocs.yaml` configuration file to integrate with Read the Docs. This will need to activate the builds there.
GiteaMirror added the pull-request label 2026-04-13 00:24:31 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/ollama#13347