Doc generation default value set by environment variable

[sj14]

Doc generation default value set by environment variable

[sj14]

Sound reasonable to me, but maybe it can be documented in v2 as it can easily lead to exposed secrets.

[meatballhat]

@sj14 Thank you for reporting this! Differentiating between "unset" and "uninitialized" values, and the precedence of value sources, have long been sources of surprising behavior. I believe that the intended behavior is that flag and env parsing should be completely separate from help text and documentation generation, so I think that treating this as a bug is very fair. I suspect that fixing this the right way will require non-trivial rework of the help text and documentation generation code, which tells me that this work should probably be targeting v3 on the main branch. Does that sound reasonable to you?

[sj14]

I may create a PR for the documentation but I can't promise 😆

[meatballhat]

@sj14 Thank you! Does any of the work required interest you? 😇