Confusing and contradictory information about paths resolving in extend #26501

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

Information is incorrect

Description

The information in the important block contradicts with what is described in the "Relative paths" section.

"Important" block says:

When you use multiple Compose files, you must make sure all paths in the files are relative to the base Compose file (i.e. the Compose file in your main-project folder). (...)

And the "Relative paths" section describes the behavior as follows:

When using extends with a file attribute which points to another folder, relative paths declared by the service being extended are converted so they still point to the same file when used by the extending service.

This is confusing and is not obvious which information is true.

Location

https://docs.docker.com/compose/how-tos/multiple-compose-files/extends/

Suggestion

Remove either the "important" block or "relative paths" section - leave only the proper information.