tofuutils
Document what priority/order is used for version selection
Right now, I cannot find clear documentation on which order version detection uses. There is a decent listing of which things can be looked at, but it's not immediately obvious which have priority.
It'd be great if the documentation have a section that clearly indicated that order.
If I've missed it feel free to clown on me 😄
It seems like the following order is used, but I've not tested thoroughly:
- Project version file
- Version file in Project Root (Possibly one anywhere in the tree above the project in order?)
- Default system-wide version defined
Notably missing: the requirements listed in the TF files, which can be installed/used with latest-allowed and min-required but it doesn't seem like this is used automatically as a fallback?
If the strict ordering is confirmed, I may be willing to PR the documentation changes 😄
The project binaries part of the README indicate the version resolution order for each binary.
However, it need a better highlighting and some clarification (on the walking tree order, I talk about it there)
Oh, awesome! I didn't see the version resolution order. That's precisely what I was looking for.
I would propose sending that information into a digestible section with version files, or perhaps it's own section.
Weary to make promises I may not deliver but I will probably take a stab at a PR with what I imagine (and I can try to clarify better, too).