OmniaGM opened a new pull request, #23833:
URL: https://github.com/apache/kafka/pull/23833
Changes
- swaps the sentinel check to `hugo.yaml` instead of `owered-by.html`
- splits the extraction: markdown goes to `content/en/<version>`, javadoc
goes to `static/<version>`
- the site-docs tar bundles images in alongside the markdown, so those get
pulled out of `content/en/<version>/images` and moved into
`static/<version>/images` right after extraction — otherwise they’d sit in the
wrong place. NOTE: I hardcoded `images` as the one directory that needs pulling
out of `content/<version>` — based on what’s actually in the tar now and what
the existing slots look like. Any future doc change bundling some other asset
directory into the tar won’t be caught by this.
- fixed a small pre-existing bug while I was in there: the sentinel failure
message was missing an `f` prefix, so it was printing `{kafka_site_repo_path}`
literally instead of the actual path
Testing
- Ran stage-docs locally twice against `4.4.0`, staged into a real
Hugo-based kafka-site clone. `content/en/44` and `static/44` come out matching
exactly what the `4.0`, `4.3.0`, and `4.3.1` slots already look like — same
top-level structure. `4.4.0` docs are published as part of
[kafka-site#925](https://github.com/apache/kafka-site/pull/925 )
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
