Skip to content

docs: initialize documentation structure#8

Merged
TordAreStromsnes merged 16 commits intomainfrom
feature/read-the-docs
Oct 14, 2025
Merged

docs: initialize documentation structure#8
TordAreStromsnes merged 16 commits intomainfrom
feature/read-the-docs

Conversation

@TordAreStromsnes
Copy link
Contributor

This pull request adds initial documentation infrastructure for the DataOrc project, including configuration for MkDocs and Read the Docs, as well as automation for maintaining a version matrix of packages. The main themes are documentation setup, tooling configuration, and automation for keeping documentation up to date.

Documentation infrastructure:

  • Added .readthedocs.yaml to configure Read the Docs builds using Python 3.12 and MkDocs with dependencies from docs/requirements.txt.
  • Created mkdocs.yml to configure the MkDocs documentation site, including theme, plugins, navigation, and repository links.
  • Added docs/index.md as the documentation homepage, with a link to the version matrix and a placeholder for future content.
  • Added docs/version-matrix.md to display a table of package versions (currently listing dataorc version 0.1.1).

Tooling and automation:

  • Added docs/requirements.txt specifying MkDocs and related plugins required for building the documentation.
  • Introduced scripts/update_version_matrix.py, a script to automatically generate or check the version-matrix.md file based on pyproject.toml files found in the repository, ensuring the version matrix stays up to date.

@TordAreStromsnes TordAreStromsnes marked this pull request as draft October 6, 2025 12:12
@TordAreStromsnes TordAreStromsnes changed the title docs: initialize documentation structure and version matrix docs: initialize documentation structure Oct 8, 2025
@TordAreStromsnes TordAreStromsnes marked this pull request as ready for review October 8, 2025 07:16
Build docs using tried-and-tested reusable workflows from [Ops
Actions](https://github.com/equinor/ops-actions).
hknutsen and others added 2 commits October 9, 2025 07:56
Co-authored-by: Henrik Knutsen <46495473+hknutsen@users.noreply.github.com>
@TordAreStromsnes TordAreStromsnes merged commit 0adb45d into main Oct 14, 2025
3 checks passed
@TordAreStromsnes TordAreStromsnes deleted the feature/read-the-docs branch October 14, 2025 08:50
TordAreStromsnes pushed a commit that referenced this pull request Feb 5, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.2.0](dataorc-v0.1.1...dataorc-v0.2.0)
(2026-02-05)


### Features

* add Azure Key Vault support and documentation
([#42](#42))
([abc42a0](abc42a0))
* create config tool for pipeline setup
([#22](#22))
([21a8a84](21a8a84))
* introduce dictionary functionality for environment variables access
([#57](#57))
([b6291fa](b6291fa))
* mount data lake ([#31](#31))
([0bb3e51](0bb3e51))
* **utils:** add argument parsing helper for Databricks wheel tasks
([#43](#43))
([393c6a2](393c6a2))
* **utils:** add retry logic and customizable parameters for
get_keyvault_secret
([#63](#63))
([acbc2b7](acbc2b7))
* **utils:** implement LakeFileSystem for data lake operations and add
documentation ([#64](#64))
([be9e738](be9e738))
* **utils:** support optional revision suffix in version format and
update tests ([#59](#59))
([8ea0b60](8ea0b60))
* **utils:** treat env as plain string and default to "dev"
([#50](#50))
([65473a8](65473a8))


### Documentation

* add changelog tab
([#20](#20))
([2ec4271](2ec4271))
* add CI status badge
([#9](#9))
([8de41fe](8de41fe))
* add contributing guidelines
([#15](#15))
([434cf31](434cf31))
* add developing instructions
([#33](#33))
([835a35e](835a35e))
* add early development phase warning
([#39](#39))
([406746d](406746d))
* bootstrap package ([#6](#6))
([afbb765](afbb765))
* build docs using uv
([#36](#36))
([15a1125](15a1125))
* initialize documentation structure
([#8](#8))
([0adb45d](0adb45d))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants