Sorry for the second PR, I just did not know how to fix the other one (#2906 ) , but it still have mysterious errors. Possibly cause I used   to intend variable level in the table ? Other than that, I see nothing in the details.

I should have put the variable section (board_manager, daemon, directories, ...) as part of the variable names, the table would have been easier to read and get rid of the   at the same time. Perhaps there's a way to create a table division , i.e. fat lines ?

We use a tool named Prettier to format the markdown documents with a consistent style:

https://arduino.github.io/arduino-cli/1.2/CONTRIBUTING/#docs-formatting

You should run this tool on the files you edited before submitting. In your case, the table does not have the vertical bars aligned, which is one of Prettier's automatically enforced styles.

You don't need to open another PR, just make another commit and push, it will update the PR and re-run the checks.

Thanks for your proposal @kristianbenoit! After some consideration, I decided that the current nested list format is the most appropriate for this information.

I noticed that, as part of this pull request, you had done some work towards documenting the true default for build_cache.path. I have carried that work forward in #2919

@per1234, the reason I used table is to have a column for default value separated from the doc. You probably noticed build_cache.path as the value was ??? for Windows and MacOS, but I added all the default values, you can see them here. I found them using arduino-cli config get build_cache.ttl. As I used completion, I found, and added a few undocumented configuration variables.

In the previous commit, I tried to keep the indentation, but I made another commit, trying to fix the "prettier" error, removing the indentation. I also added a few things in that second commit. I guess I should add what I've done to the current format, but where should I systematically add the default values ? In parentheses after the doc string ?