render-engine 2026.3.3__tar.gz → 2026.3.4a2__tar.gz

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,8 @@
 <!--
 SUMMARY OF THE CHANGES BEING MADE
 Be sure to include any referenced issues and discussions.
+
+Not following this guideline will result in the immediate rejection of your PR.
 -->
 
 #### Type of Issue

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/.github/workflows/lint.yml

@@ -16,25 +16,21 @@ jobs:
       - uses: actions/checkout@v6.0.1
         with:
           fetch-depth: 0
-      - name: Install Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.12"
-          cache: 'pip' # caching pip dependencies
+          python-version: 3.14
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install "ruff==0.11.12"
-      - name: Check Linting
-        run: ruff check . --output-format=github
+        run: uvx ruff check . --output-format=github
       - name: Check formatting
-        run: ruff format . --check
+        run: uvx ruff format . --check
 
   lint-docs:
     name: Lint Markdown
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6.0.1
-      - uses: oven-sh/setup-bun@v2
-      - name: Lint files
-        run: bunx markdownlint-cli2 **/*.md
+      - name: lint-test
+        uses: DavidAnson/markdownlint-cli2-action@v22
+        with:
+          globs: '**/*.md'

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/.github/workflows/publish.yml

@@ -17,16 +17,13 @@ jobs:
       - name: Checkout source
         uses: actions/checkout@v6.0.1
 
-      - name: Set up Python 3.11
-        uses: actions/setup-python@v5
+      - name: Set up Python
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
-          cache: 'pip' # caching pip dependencies
-      - name: Install build dependencies
-        run: python -m pip install build twine
+          python-version: 3.14
 
       - name: Build distributions
-        run: python -m build
+        run: uv build
 
       - name: Publish package to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

render_engine-2026.3.4a2/.github/workflows/todos.yml

@@ -0,0 +1,31 @@
+name: "Run TODO to Issue"
+on:
+  pull_request:
+    branches: [main]
+jobs:
+  build:
+    runs-on: "ubuntu-latest"
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: "actions/checkout@v6"
+      - name: "TODO to Issue"
+        uses: "alstr/todo-to-issue-action@v5"
+        with:
+          INSERT_ISSUE_URLS: "true"
+          CLOSES_ISSUE: "true"
+      - name: Set Git user
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+      - name: Commit and Push Changes
+        run: |
+          git add -A
+          if [[ `git status --porcelain` ]]; then
+            git commit -m "Automatically added GitHub issue links to TODOs"
+            git push origin main
+          else
+            echo "No changes to commit"
+          fi

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/.github/workflows/ty.yml

@@ -19,4 +19,4 @@ jobs:
       - uses: actions/checkout@v6.0.1
       - uses: astral-sh/setup-uv@v7
       - name: Run type (ty) check
-        run: uv run ty check src
+        run: uv run ty check src

render_engine-2026.3.4a2/.markdownlint.json

@@ -0,0 +1,13 @@
+{
+  "MD013": {
+    "line_length": 120,
+    "tables": false,
+    "code_blocks": false
+  },
+  "MD041": false,
+  "MD054": {
+    "inline": false,
+    "url_inline": false,
+    "collapsed": false
+  }
+}

render_engine-2026.3.4a2/.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.3.0
+    hooks:
+    -   id: check-yaml
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  # Ruff version.
+  rev: v0.15.1
+  hooks:
+    # Run the linter.
+    - id: ruff-check
+      args: [ --fix ]
+    # Run the formatter.
+    - id: ruff-format
+- repo: local
+  hooks:
+    - id: ty-check
+      name: ty
+      entry: uv run ty check src/render_engine
+      language: system
+      types: [python]
+      pass_filenames: false
+- repo: https://github.com/DavidAnson/markdownlint-cli2
+  rev: v0.6.0
+  hooks:
+    - id: markdownlint-cli2
+- repo: local
+  hooks:
+    - id: deptry
+      name: deptry
+      entry: uv run deptry src
+      language: system
+      always_run: true
+      pass_filenames: false

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2026.3.3
+Version: 2026.3.4a2
 Summary: A Flexible Static Site Generator for Python
 Project-URL: homepage, https://github.com/render-engine/render-engine/
 Project-URL: repository, https://github.com/render-engine/render-engine/
@@ -8,11 +8,9 @@ Project-URL: documentation, https://render-engine.readthedocs.io/en/latest/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: jinja2
-Requires-Dist: markdown2
 Requires-Dist: more-itertools
 Requires-Dist: pluggy
 Requires-Dist: python-dateutil
-Requires-Dist: python-frontmatter
 Requires-Dist: python-slugify
 Requires-Dist: render-engine-parser
 Requires-Dist: render-engine-markdown
@@ -30,15 +28,15 @@ Requires-Dist: render-engine-sitemap; extra == "extras"
 
 # Render Engine
 
-[![PyTest](https://github.com/kjaymiller/render_engine/actions/workflows/test.yml/badge.svg)](https://github.com/kjaymiller/render_engine/actions/workflows/test.yml)
-![genbadge-coverage](./coverage-badge.svg)
-[![Discord](https://img.shields.io/discord/1174377880118104156?label=Discord&color=purple)](https://discord.gg/2xMQ4j4d8m)
+[![PyTest][pytest-badge]][pytest-action]
+![genbadge-coverage][coverage-badge]
+[![Discord][discord-badge]][discord-link]
 
 ## Learn More
 
-- [Check out the Documentation](https://render-engine.readthedocs.io/en/latest/)
-- [Contributors and Builders, Check out the Wiki](https://github.com/render-engine/render-engine/wiki)
-- [Join the community!](https://discord.gg/2xMQ4j4d8m)
+- [Check out the Documentation][docs]
+- [Contributors and Builders, Check out the Wiki][wiki]
+- [Join the community!][discord-link]
 
 ## What is RenderEngine
 
@@ -53,10 +51,10 @@ Requires-Dist: render-engine-sitemap; extra == "extras"
 
 ## Installing Render Engine
 
-To use the render engine, you must have Python 3.10 or greater installed. You can download Python from [python.org](https://python.org).
+To use the render engine, you must have Python 3.10 or greater installed. You can download Python from [python.org][python].
 
-- Linux/MacOS: [python.org](https://python.org)
-- Windows: [Microsoft Store](https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K)
+- Linux/MacOS: [python.org][python]
+- Windows: [Microsoft Store][ms-store]
 
 Render Engine is available in PyPI and can be installed using pip:
 
@@ -72,7 +70,7 @@ pip install render-engine[cli]
 
 ## Getting Started
 
-Check out the [Getting Started](https://render-engine.readthedocs.io/en/latest/page/) Section in the [Documentation](https://render-engine.readthedocs.io)
+Check out the [Getting Started][getting-started] Section in the [Documentation][docs]
 
 ## Finding Awesome Add-Ons
 
@@ -127,10 +125,21 @@ Please review the [contributing][contributing] section of our docs for more info
 
 ### Sponsors at the $20/month and Higher Level
 
-- [Brian Douglas](https://github.com/bdougie)
+- [Brian Douglas][bdougie]
 
 Thank you to them and all of those who continue to support this project!
 
+[pytest-badge]: https://github.com/kjaymiller/render_engine/actions/workflows/test.yml/badge.svg
+[pytest-action]: https://github.com/kjaymiller/render_engine/actions/workflows/test.yml
+[coverage-badge]: ./coverage-badge.svg
+[discord-badge]: https://img.shields.io/discord/1174377880118104156?label=Discord&color=purple
+[discord-link]: https://discord.gg/2xMQ4j4d8m
+[docs]: https://render-engine.readthedocs.io/en/latest/
+[wiki]: https://github.com/render-engine/render-engine/wiki
+[python]: https://python.org
+[ms-store]: https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K
+[getting-started]: https://render-engine.readthedocs.io/en/latest/page/
+[bdougie]: https://github.com/bdougie
 [contributing]: https://render-engine.readthedocs.io/en/latest/contributing/CONTRIBUTING/
 [page-docs]: https://render-engine.readthedocs.io/en/latest/page/
 [collection-docs]: https://render-engine.readthedocs.io/en/latest/collection/

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/README.md

@@ -6,15 +6,15 @@
 
 # Render Engine
 
-[![PyTest](https://github.com/kjaymiller/render_engine/actions/workflows/test.yml/badge.svg)](https://github.com/kjaymiller/render_engine/actions/workflows/test.yml)
-![genbadge-coverage](./coverage-badge.svg)
-[![Discord](https://img.shields.io/discord/1174377880118104156?label=Discord&color=purple)](https://discord.gg/2xMQ4j4d8m)
+[![PyTest][pytest-badge]][pytest-action]
+![genbadge-coverage][coverage-badge]
+[![Discord][discord-badge]][discord-link]
 
 ## Learn More
 
-- [Check out the Documentation](https://render-engine.readthedocs.io/en/latest/)
-- [Contributors and Builders, Check out the Wiki](https://github.com/render-engine/render-engine/wiki)
-- [Join the community!](https://discord.gg/2xMQ4j4d8m)
+- [Check out the Documentation][docs]
+- [Contributors and Builders, Check out the Wiki][wiki]
+- [Join the community!][discord-link]
 
 ## What is RenderEngine
 
@@ -29,10 +29,10 @@
 
 ## Installing Render Engine
 
-To use the render engine, you must have Python 3.10 or greater installed. You can download Python from [python.org](https://python.org).
+To use the render engine, you must have Python 3.10 or greater installed. You can download Python from [python.org][python].
 
-- Linux/MacOS: [python.org](https://python.org)
-- Windows: [Microsoft Store](https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K)
+- Linux/MacOS: [python.org][python]
+- Windows: [Microsoft Store][ms-store]
 
 Render Engine is available in PyPI and can be installed using pip:
 
@@ -48,7 +48,7 @@ pip install render-engine[cli]
 
 ## Getting Started
 
-Check out the [Getting Started](https://render-engine.readthedocs.io/en/latest/page/) Section in the [Documentation](https://render-engine.readthedocs.io)
+Check out the [Getting Started][getting-started] Section in the [Documentation][docs]
 
 ## Finding Awesome Add-Ons
 
@@ -103,10 +103,21 @@ Please review the [contributing][contributing] section of our docs for more info
 
 ### Sponsors at the $20/month and Higher Level
 
-- [Brian Douglas](https://github.com/bdougie)
+- [Brian Douglas][bdougie]
 
 Thank you to them and all of those who continue to support this project!
 
+[pytest-badge]: https://github.com/kjaymiller/render_engine/actions/workflows/test.yml/badge.svg
+[pytest-action]: https://github.com/kjaymiller/render_engine/actions/workflows/test.yml
+[coverage-badge]: ./coverage-badge.svg
+[discord-badge]: https://img.shields.io/discord/1174377880118104156?label=Discord&color=purple
+[discord-link]: https://discord.gg/2xMQ4j4d8m
+[docs]: https://render-engine.readthedocs.io/en/latest/
+[wiki]: https://github.com/render-engine/render-engine/wiki
+[python]: https://python.org
+[ms-store]: https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K
+[getting-started]: https://render-engine.readthedocs.io/en/latest/page/
+[bdougie]: https://github.com/bdougie
 [contributing]: https://render-engine.readthedocs.io/en/latest/contributing/CONTRIBUTING/
 [page-docs]: https://render-engine.readthedocs.io/en/latest/page/
 [collection-docs]: https://render-engine.readthedocs.io/en/latest/collection/

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/collection.md

@@ -23,7 +23,7 @@ class BasicCollection(Collection):
 
 Collection pages **MUST** come from a `content_path` and all be the same content type.
 
-`content_path` can be a string representing a path or URL, depending on the [parser](parsers.md?id=basepageparser) used.
+`content_path` can be a string representing a path or URL, depending on the [parser] used.
 
 `sort_by` can be either a single `attribute` as a `str` or a `list` of attributes to be used as a sort key.
 
@@ -54,7 +54,7 @@ content_manager_extras: dict[str, Any]: Configuration options to send to the `Co
 
 `archives: typing.Generator[Archive, None, None]` `property`
 
-Returns a [Archive](archive.md) objects containing the pages from the `content_path`.
+Returns a [Archive] objects containing the pages from the `content_path`.
 
 Archives are an iterable and the individual pages are built shortly after the collection pages are
 built. This happens when [Site.render][site-render] is called.
@@ -63,7 +63,7 @@ built. This happens when [Site.render][site-render] is called.
 
 `get_page(content_path=None)`
 
-Returns the [page](page.md) Object for the specified Content Path
+Returns the [page] Object for the specified Content Path
 
 `iter_content_path()`
 
@@ -109,6 +109,11 @@ You can have archives generated by setting the `has_archive` to True.
 If you call `archives` from your collection and neither `has_archive` nor `items_per_page` is set,
 an error will be raised and an archive containing all pages will be generated.
 
-For more information, see [Collection Archives](archive.md).
+For more information, see [Collection Archives].
 
 [site-render]: site.md?id=render
+
+[archive]: archive.md
+[collection archives]: archive.md
+[page]: page.md
+[parser]: parsers.md?id=basepageparser

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/content_manager.md

@@ -15,7 +15,7 @@ content is stored in the file system with each piece of content existing in a di
 
 ## Selecting a `ContentManager`
 
-The `ContentManager` for a given [`Collection`](collection.md) is controlled by the `ContentManager` attribute. When
+The `ContentManager` for a given [`Collection`] is controlled by the `ContentManager` attribute. When
 the class is instantiated the `ContentManager` is also instantiated with any `content_manager_extras` being passed
 as arguments. To access the `ContentManager` of a given `Collection` use the `content_manager` attribute.
 
@@ -85,3 +85,5 @@ content: str = None  # Updated content
 ```
 
 [file-content-manager]: https://github.com/render-engine/render-engine/blob/main/src/render_engine/content_managers/file_content_manager.py
+
+[`collection`]: collection.md

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/CONTRIBUTING.md

@@ -13,7 +13,7 @@ Docs can be found at <https://render-engine.readthedocs.org>
 
 ## Code of Conduct
 
-Render Engine and all of the packages in this org follow the same [Code of Conduct](https://github.com/render-engine/render-engine/blob/main/.github/CODE_OF_CONDUCT.md).
+Render Engine and all of the packages in this org follow the same [Code of Conduct].
 
 ## Before you Contribute
 
@@ -23,7 +23,7 @@ When suggesting a feature, consider the following:
 - Would your feature be a good theme?
 - Could this be implemented as a Custom Parsers or Collections
 
-More on when to choose these solutions in our [docs](https://render-engine.readthedocs.io/en/latest/contributing/CONTRIBUTING/#instead-of-making-a-change-in-render-engines-code-consider).
+More on when to choose these solutions in our [docs][docs-contributing].
 
 ## Filing an Issue
 
@@ -37,6 +37,7 @@ If you see or experience a problem, please file an issue. Include any important
 - Plugins/Themes/Custom Parsers & Collections Installed
 - Commands/Code Used
 - Output
+- [AI Attestation][ai-attestation]
 
 ## Wait to be Assigned Issues
 
@@ -74,6 +75,12 @@ all supported versions.
 - 🚫 changes aren't breaking existing code (failing tests)
 - 🚫 Ensure new dependencies are listed, justified, and approved to be added.
 
+## TODOs
+
+Todos are not encouraged all the time but if necessary please indicate any todos with the `# TODO Prefix`.
+We use [todo-to-issue] as a github action that will create issues for any TODOs that are created.
+This will modify your code with the issue number and link to the TODO in the comments.
+
 ## Contributing to Documentation
 
 Render Engine uses [readthedocs][readthedocs] in combination with [MkDocs][mkdocs],
@@ -98,7 +105,25 @@ If you're starting from a blank PR be sure to include the following:
 - issue(s)/discussions being addressed
 - Documentation or tests added/updated
 - Any follow up tasks pending
+- [AI Attestation][ai-attestation]
+
+When submitting your PR, please be sure to use the template provided.
+**Not following this guideline will result in the immediate rejection of your PR.**
+
+## AI Attestation
+
+Projects in the [Render Engine organization][gh-render-engine] will accept code contributions created with the
+assistance of AI Coding software. We ask that that you include an AI Attestation to your issue, comment, or PR.
+
+This attestation should mean that the AI model is included as a co-Author of the changes.
+
+The AI assistant is your copilot. You are still responsible for code changes submitted.
+Low quality contributions or code that cannot be defended by the USER (not their AI model)
+will result in issues/prs being immediately closed.
+Multiple low quality contributions will result in your user account being banned from contribution.
 
+[ai-attestation]: #ai-attestation
+[gh-render-engine]: https://github.com/render-engine
 [wiki]: https://github.com/render-engine/.github/wiki
 [docs]: https://render-engine.readthedocs.org
 [being-assigned]: https://render-engine.readthedocs.io/en/latest/contributing/CONTRIBUTING/#being-assigned-an-issue
@@ -109,3 +134,6 @@ If you're starting from a blank PR be sure to include the following:
 [mkdocs]: https://www.mkdocs.org
 [material]: https://squidfunk.github.io/mkdocs-material/
 [mkdocsstrings]: https://mkdocsstrings.readthedocs.io/en/latest/
+[code of conduct]: https://github.com/render-engine/render-engine/blob/main/.github/CODE_OF_CONDUCT.md
+[docs-contributing]: https://render-engine.readthedocs.io/en/latest/contributing/CONTRIBUTING/#instead-of-making-a-change-in-render-engines-code-consider
+[todo-to-issue]: https://github.com/marketplace/actions/todo-to-issue

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/SECURITY.md

@@ -5,10 +5,10 @@
 We only support the latest version of render-engine with security updates.
 Please ensure you are using the most recent release available on [PyPI].
 
-| Version    | Supported          |
-|------------|--------------------|
-| Latest     | :white_check_mark: |
-| < Latest   | :x:                |
+| Version  | Supported |
+|----------|-----------|
+| Latest   | ✅        |
+| < Latest | ❌        |
 
 ## Reporting a Vulnerability
 

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/environment_setup.md

@@ -49,7 +49,7 @@ Available recipes:
 If you're using [Visual Studio Code][vscode] you can also create a virtual environment from the command
 pallet. This will also enable the installation of the dependencies.
 
-![Creating an Environment using VS Code](<../assets/create environment vs code.gif>)
+![Creating an Environment using VS Code]
 
 ## Using Codespaces
 
@@ -57,7 +57,7 @@ You can create a new codespace to quickly get started with your project.
 
 You can create a codespace on main.
 
-![Create a Codespace](../assets/create-codespace.gif)
+![Create a Codespace]
 
 This will create a codespace in which you can make your changes. Don't worry they won't let you push your
 changes directly to the codebase but when you go to make that change it will let you create a fork and
@@ -77,12 +77,17 @@ Start with ensuring that the docker daemon is running.
 Open your fork of the project in VS Code and open the command pallet. Next, Enter "Dev Containers: ReOpen
 in Container" and select the option.
 
-This will create a new local environment with the same configuration as the [codespace](#using-codespaces).
+This will create a new local environment with the same configuration as the [codespace].
 
-![Launching a Dev Container](<../assets/launching a dev container.gif>)
+![Launching a Dev Container]
 
 [uv]: https://github.com/astral-sh/uv
 [uv-installation]: https://github.com/astral-sh/uv?tab=readme-ov-file#installation
 [just]: https://github.com/casey/just
 [just-installation]: https://github.com/casey/just?tab=readme-ov-file#installation
 [vscode]: https://code.visualstudio.com/
+
+[codespace]: #using-codespaces
+[create a codespace]: ../assets/create-codespace.gif
+[creating an environment using vs code]: ../assets/create%20environment%20vs%20code.gif
+[launching a dev container]: ../assets/launching%20a%20dev%20container.gif

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/gen_badge.md

@@ -6,7 +6,7 @@ date: Jan 24, 2026
 
 Render Engine shows a badge of it's coverage report and other information.
 
-This badge is generated using [genbadge](https://smarie.github.io/python-genbadge/).
+This badge is generated using [genbadge].
 
 The badge is autogenerated via github actions. To manually generate a new badge, you can run the following commands.
 
@@ -20,3 +20,5 @@ You can generate this badge with just:
 ```bash
 just badge
 ```
+
+[genbadge]: https://smarie.github.io/python-genbadge/

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/github-actions-file-patterns.md

@@ -243,6 +243,10 @@ If your workflow runs more often than expected:
 
 ## Additional Resources
 
-- [GitHub Actions: Workflow syntax for paths](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore)
-- [GitHub Actions: Filter pattern cheat sheet](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)
-- [GitHub Actions Labeler](https://github.com/actions/labeler) - For automatic PR labeling based on file patterns
+- [GitHub Actions: Workflow syntax for paths]
+- [GitHub Actions: Filter pattern cheat sheet]
+- [GitHub Actions Labeler] - For automatic PR labeling based on file patterns
+
+[github actions labeler]: https://github.com/actions/labeler
+[github actions: filter pattern cheat sheet]: https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet
+[github actions: workflow syntax for paths]: https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/style-guide.md

@@ -10,7 +10,7 @@ Render Engine project.
 
 ### Ruff (Python)
 
-Render Engine uses [Ruff](https://docs.astral.sh/ruff/) for Python linting and formatting with the following
+Render Engine uses [Ruff] for Python linting and formatting with the following
 configuration:
 
 - **Line length**: 120 characters
@@ -177,3 +177,5 @@ format DIRECTORY='.':
 format-fix DIRECTORY='.':
     uvx ruff format {{ DIRECTORY }}
 ```
+
+[ruff]: https://docs.astral.sh/ruff/

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/contributing/testing.md

@@ -36,7 +36,7 @@ These tools can be called via `just`. If you wanted to run them without `just` y
 
 ### Type Checking
 
-See our section on [typechecking](/contributing/typechecking/)
+See our section on [typechecking]
 
 ### Linting and Formatting
 
@@ -67,3 +67,5 @@ uvx ruff check . --fix
 uvx ruff format .
 uvx ruff check .
 ```
+
+[typechecking]: /contributing/typechecking/

render_engine-2026.3.4a2/docs/docs/data_object.md

@@ -0,0 +1,65 @@
+---
+title: "Data Objects"
+description: "Overview of Data Objects in Render Engine"
+date: March 15, 2026
+tags: ["data_objects"]
+---
+<!-- markdownlint-disable MD056 -->
+While Render Engine is a static site generator, there are times when it might be useful to have machine-readable data
+available on your site. For example, if you wish to include a [humans.json] file it might be simpler to maintain as a
+Python dictionary and have Render Engine output the JSON.
+
+## DataObject
+
+The `DataObject` base class allows for the rendering of a serializable Python object to the site's file system during
+site rendering.
+
+### Attributes
+
+| Name              | Type          | Description                                                               |
+|-------------------|---------------|---------------------------------------------------------------------------|
+| `data_object`     | `Any`         | The object to serialize.                                                  |
+| `serializer`      | 'Callable`    | The function to serialize with.                                           |
+| `serializer_args` | dict          | Optional `kwargs` to be passed to the `serializer` along with the object. |
+| `routes`          | list          | List of directories to output the serialized object to.                   |
+| `path_name`       | `str \| Path` | The filename to output the serialized data to.                            |
+
+The `serializer` is a function that takes a single positional argument and optional `**kwargs`. Should you wish to use
+a function with a different signature, you will need to write a wrapper around it.
+
+The default `serialize` function is `json.dumps`.
+
+### Configuring a `DataObject`
+
+There are 2 ways to configure a `DataObject` and add it to your `Site`:
+
+1. Using the `Site.data_object` decorator:
+
+    ```python
+    import toml
+    from render_engine import Site, DataObject
+
+    app = Site()
+
+    @app.data_object
+    class MyDataObject(DataObject):
+        data_object = {'foo': 'bar'}
+        serializer = toml.dumps
+    ```
+
+2. Using the `Site.data_object` method:
+
+    ```python
+    import toml
+    from render_engine import Site, DataObject
+
+    app = Site()
+
+    class MyDataObject(DataObject):
+        data_object = {'foo': 'bar'}
+        serializer = toml.dumps
+
+    app.data_object(MyDataObject)
+    ```
+
+[humans.json]: https://codeberg.org/robida/human.json

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/feeds.md

@@ -11,9 +11,9 @@ Feed Objects for Generating RSS Feeds
 
 `RSSFeed`
 
-Bases: [`BasePage`](page.md?id=basepage)
+Bases: [`BasePage`]
 
-Creates an RSS feed [Page](page.md) Object.
+Creates an RSS feed [Page] Object.
 
 > !!! Note
     This is the base object type and should only contain the params identified by the
@@ -37,3 +37,6 @@ This is built using the built-in `rss2.0.xml` jinja template.
     ```
 
 [rss-spec]: http://www.rssboard.org/rss-specification
+
+[`basepage`]: page.md?id=basepage
+[page]: page.md

{render_engine-2026.3.3 → render_engine-2026.3.4a2}/docs/docs/getting-started/building-your-site.md

@@ -7,7 +7,7 @@ date: August 22, 2024
 tags: ["building", "site-generation", "render-engine"]
 ---
 
-Once you've created the [layout](layout.md) of your site, you can start building it.
+Once you've created the [layout] of your site, you can start building it.
 
 ## Calling `render()`
 
@@ -39,3 +39,5 @@ render-engine build app:app
 Your site will be generated in the `output` folder.
 
 [cli-build]: ../cli.md#building-your-site-with-render-engine-build
+
+[layout]: layout.md