Document includeAll does so in depth recursively

Description

Refactoring an initial source:

into:

causes the changesets from "migrate/foo/baz.xml" and "migrate/foo/qux.xml" to be duplicated in the parsed result. Although Liquibase would just skip running the changes the second time around (as mentioned in the [Include Tag](https://www.liquibase.org/documentation/include.html) documentation) I think the behavior should be explicitly documented:

https://www.liquibase.org/documentation/includeall.html

In the given case changes from "migrate/foo/baz.xml" might try to run before ones in "migrate/1_foo.xml" which could be a problem.

One could consider adding an option to includeAll for controlling the recursive behavior, also.

Environment

Any.

Reporter

Stanimir Stamenkov

Affects versions

Priority

Minor
Configure