Some more documentation on how to use expressions in Python code would be useful

[carbon-starlight]

Documentation shows how to use expressions in general, docs on PyPI (https://pypi.org/project/cucumber-expressions/) only talk about building the library. Showing actual usage (how to import to code, how to assign a variable with a found value) somewhere would be nice.

[jenisys]

That is right. The README should be improved (IMHO).
BUT:

• Have you looked at the tests ?
• Tests often provide the best examples how to use code.

OTHERWISE: User perspective (if it helps)

• Short description of cucumber-expressions in behave using a thin adapter layer over cucumber-expressions
• features/step_matcher.cucumber_expressions.feature