This repository holds the documentation of the Development Finance Observatory (DFO), an initiative of ONE Data built on Google Data Commons. It also holds the build that gathers pages from the DFO's other repositories into one corpus for the DFO website.
The published docs are at https://developmentfinance.org/docs. Public launch is expected in late 2026.
This repository is under active development. Interfaces, schemas, and data may change without notice.
content/hub/ hub pages, written here: Get started, Build, Data, Skills, About
roadmap/ the DFO roadmap, one YAML file per track
hub.yaml the site nav: hub pages, grouping headings, and source mounts
sources.yaml the registry of repositories whose docs the build fetches
docsync.yaml the sources published as Google Docs for editors who do not use GitHub
src/dfo_docs/ the build and the docsync tool
scripts/ build.py and check_nav.py
tests/ the test suite
Every other page lives in the docs/ folder of its own repository, such as apis, ai, and skills, or in a package repository under ONEcampaign, and sources.yaml points the build at it. To change one of those pages, open a pull request in the repository that holds it. The org profile links every DFO repository.
Everything here runs without access to ONE's Google Cloud project, because the build clones public repositories anonymously. You need uv and Python 3.13.
uv sync
uv run python scripts/build.py --out /tmp/dfo-docs-buildThe build writes corpus/ and manifest.json under the output directory. The Google Docs sync (dfo-docsync) needs ONE credentials and is for maintainers.
- CONTRIBUTING.md explains how to edit a hub page, page modes, style, the link rules, and how a repository publishes its docs.
- docs/development.md holds maintainer notes: the source registry, build failures, and the Google Docs sync.
Issues and pull requests are welcome. See CONTRIBUTING.md.
MIT. See LICENSE.