Skip to content

use markdown links in top-level readme and add docs rebuild downstream workflow - #4

Open
RaphvK wants to merge 10 commits into
mainfrom
fix-links
Open

use markdown links in top-level readme and add docs rebuild downstream workflow#4
RaphvK wants to merge 10 commits into
mainfrom
fix-links

Conversation

@RaphvK

@RaphvK RaphvK commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

The inline HTML links cannot be resolved by Sphinx HTML generation (see here). So, I replaced them with conventional markdown links. Somehow, the icon used in the link to the "architecture" section had to be replaced to make that work.

To ensure that changes in markdown files in this repository are also validated and updated in the OpenADS docs repo, a downstream workflow was added, that is triggered on changes in *.md files. It triggers a docs rebuild in the downstream repo on changes in markdown files here using the branch triggering the downstream workflow. When changes in markdown files are commited to the main branch here, a new deployment to GitHub Pages (https://openads-project.github.io) is automatically triggered in the docs repo.

Tests

@RaphvK
RaphvK requested review from cgeller and jpbusch July 30, 2026 06:50
@RaphvK
RaphvK marked this pull request as draft July 30, 2026 06:51
@RaphvK

RaphvK commented Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

I will add triggering the docs generation as downstream pipeline in this PR

@RaphvK RaphvK changed the title use markdown links in top-level readme use markdown links in top-level readme and add docs rebuild downstream workflow Jul 30, 2026
# openadstack submodule and builds the docs from exactly these changes.
OPENADSTACK_REF: ${{ github.ref_name }}
DOWNSTREAM_REPO: openads-project/openads-project.github.io
DOWNSTREAM_REF: downstream-pipeline # TODO: switch to main

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
DOWNSTREAM_REF: downstream-pipeline # TODO: switch to main
DOWNSTREAM_REF: main

apply once merged: openads-project/openads-project.github.io#9

@RaphvK
RaphvK marked this pull request as ready for review July 30, 2026 07:34
@RaphvK
RaphvK requested a review from cgeller July 30, 2026 07:34
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