This repository is the source for User Documentation for Ibexa DXP, a digital experience platform that is based on the Symfony Full Stack Framework in PHP.

1. Ibexa DXP Developer Hub: https://developers.ibexa.co
2. Ibexa DXP Repository: https://github.com/ibexa/oss
3. Open JIRA board: https://issues.ibexa.co
4. Ibexa Website: https://ibexa.co
5. User Documentation: https://doc.ibexa.co/projects/userguide

To contribute to the documentation, you can open a PR in this repository.

If you'd like to see Ibexa DXP in your language, you can contribute to the translations.

To build and preview your changes locally, you need to install Python along with its package manager (pip). To install other required tools, use the following command:

pip install -r requirements.txt

Then you can run:

mkdocs serve

After a short while your documentation should be reachable at http://localhost:8000. If it's not, check the output of the command.

External links in the built documentation are checked using lychee.

# 1. Build the main docs site
mkdocs build --strict

# 2. Clone and build versioned repositories, and generate lychee.toml
./tools/clone-repositories.sh

# 3. Check links
lychee --config lychee.toml --cache --cache-exclude-status "400.." site

After fixing any reported links, run mkdocs build --strict before rerunning lychee.

The script accepts optional branch names before cloning repositories:

./tools/clone-repositories.sh [DEVDOC_50] [DEVDOC_46] [USERDOC_50] [USERDOC_46] [CONNECT]

Example — checking link for release PRs:

./tools/clone-repositories.sh release-5.0.10 release-4.6.70 4.6 4.6 main

The same parameters are available as inputs when triggering the GitHub Actions workflow manually.

https://doc.ibexa.co