Skip to content

Removed title and descritpion extraction from HTML - #3341

Open
mnocon wants to merge 1 commit into
5.0from
fix-package-tagging
Open

Removed title and descritpion extraction from HTML#3341
mnocon wants to merge 1 commit into
5.0from
fix-package-tagging

Conversation

@mnocon

@mnocon mnocon commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Target: 4.6, 5.0, 6.0, user doc

If you look at https://github.com/ibexa/documentation-developer/tags , you might see that a tag is created every day.

That's not supposed to happen, the tag should be created only when there's new content in the documentation.

The tags were created (incorrectly) because there was an actual difference in documentation content between them - turns out that our builds were not reproducible and relied on doc.ibexa.co access.

If requests to doc.ibexa.co succeeded: title and description were extracted, all good
If requests to doc.ibexa.co failed: they failed silently, title and description were set to empty

And we were not notified at all that it happens!

This has happened a couple of times when building the "Composer package" version of the doc (Cloudflare likes to respond with 429 for requests to doc.ibexa.co coming from GitHub Actions) and caused the content to fluctuate every day.

TBH it's possible that it was broken on the live site and we've never noticied.
And making requests whenever mkdocs build is run feels weird.

This PR:

  1. Adds the titles and descriptions as they were extracted every time
  2. Removes the "Extract title and description" from HTML pages (both external and internal) - it still works for Markdown files

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

"commerce/shopping_list/shopping_list_design",
"commerce/shopping_list/shopping_list_api",
("api/php_api/php_api_reference/namespaces/ibexa-contracts-shoppinglist.html", "PHP API Reference", "<code>Ibexa\Contracts\ShoppingList</code>"),
("api/php_api/php_api_reference/namespaces/ibexa-contracts-shoppinglist.html", "PHP API Reference", "<code>Ibexa\\Contracts\\ShoppingList</code>"),

@mnocon mnocon Aug 5, 2026

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.

The \C was responsible for:

INFO - DeprecationWarning: invalid escape sequence '\C'

visible in the builds (https://github.com/ibexa/documentation-developer/actions/runs/30985847130/job/92240292415)

So it's not related to this PR, but small enoguh that IMHO can be included here.

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

Summary

Status Count
🔍 Total 736658
🔗 Unique 14773
✅ Successful 6198
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 730460
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 0

Full Github Actions output

@mnocon
mnocon marked this pull request as ready for review August 5, 2026 08:29
@mnocon
mnocon requested a review from a team August 5, 2026 08:31
@ibexa-workflow-automation-1
ibexa-workflow-automation-1 Bot requested review from adriendupuis, dabrt and julitafalcondusza and removed request for a team August 5, 2026 08:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant