Skip to content

AFDocs: Improve docs accessibility for agents - #415

Merged
mnocon merged 6 commits into
5.0from
afdocs
Jul 22, 2026
Merged

AFDocs: Improve docs accessibility for agents#415
mnocon merged 6 commits into
5.0from
afdocs

Conversation

@mnocon

@mnocon mnocon commented Jul 17, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Target: 5.0, 6.0

Companion PR for ibexa/documentation-developer#3297 , with changes that can be done only in this repo.

For explanation of this changes, see the PR description in dev doc, but I think this screenshot sums it nicely:

Screenshot 2026-07-17 at 16 23 08

Removed navigation in Markdown:

~ ❯ curl -H "Accept: text/markdown" https://ez-systems-developer-documentation--415.com.readthedocs.build/projects/userguide/en/415/getting_started/get_started/                                     24.4.0 15:03:57
---
description: Get started with Ibexa DXP by logging in to the back office.
---

<!doctype html>

[Skip to content ](#get-started)

For AI agents: the complete documentation index is available at [llms.txt](https://ez-systems-developer-documentation--415.com.readthedocs.build/projects/userguide/en/415/llms.txt)This page is also [available as Markdown](https://ez-systems-developer-documentation--415.com.readthedocs.build/projects/userguide/en/415/getting%5Fstarted/get%5Fstarted/index.md).

* Documentation >
* Getting started >
* Get started

# Get started[¶](#get-started "Permanent link")

Ibexa DXP consists of the technical platform for creating and managing online experiences, designed for developers and end-users alike. It includes a web framework, APIs and a content repository. It features a customizable user interface where you can work with the content, products, media, manage other functionalities, and administer the platform.

@github-actions

github-actions Bot commented Jul 17, 2026

Copy link
Copy Markdown

Preview of modified files: no change to preview.

@mnocon mnocon mentioned this pull request Jul 21, 2026
Merged
mnocon
mnocon commented Jul 21, 2026
View reviewed changes
Comment thread plugins.yml
- llmstxt:
preprocess: llmstxt_preprocess.py

markdown_description: >-

@mnocon mnocon Jul 21, 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.

Result: https://ez-systems-developer-documentation--415.com.readthedocs.build/projects/userguide/en/415/llms.txt

mnocon
mnocon commented Jul 21, 2026
View reviewed changes
Comment thread theme/main.html


{% block content %}
<!-- Discovery directive for AI agents; visually hidden -->

@mnocon mnocon Jul 21, 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.

Not visible in the browser: https://ez-systems-developer-documentation--415.com.readthedocs.build/projects/userguide/en/415/ai_actions/ai_actions/

@mnocon mnocon changed the title AFDocs: LLM and Markdown discoverability AFDocs: Improve docs accessibility for agents Jul 21, 2026
@mnocon
mnocon requested a review from a team July 21, 2026 13:05
@mnocon
mnocon marked this pull request as ready for review July 21, 2026 13:05
@ibexa-workflow-automation-1
ibexa-workflow-automation-1 Bot requested review from adriendupuis, dabrt and julitafalcondusza and removed request for a team July 21, 2026 13:05
@mnocon
mnocon merged commit 8ac935c into 5.0 Jul 22, 2026
10 checks passed
@mnocon
mnocon deleted the afdocs branch July 22, 2026 08:03
mnocon added a commit that referenced this pull request Jul 22, 2026
@mnocon
AFDocs: Improve docs accessibility for agents (#415)
a2a95ea 
* AFDocs: LLM and Markdown discoverability

* Updated base_url for llmstxt

* Fixed baseurl

* Updated description

* Added blockquote

* Nav -> div changes
mnocon added a commit that referenced this pull request Jul 22, 2026
@mnocon
AFDocs: Improve docs accessibility for agents (#415)
61e3d5c 
* AFDocs: LLM and Markdown discoverability

* Updated base_url for llmstxt

* Fixed baseurl

* Updated description

* Added blockquote

* Nav -> div changes
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@adriendupuis adriendupuis adriendupuis approved these changes
@dabrt dabrt Awaiting requested review from dabrt
@julitafalcondusza julitafalcondusza Awaiting requested review from julitafalcondusza

Assignees

No one assigned

Labels

Needs DOC review

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@mnocon @adriendupuis