kamal icon indicating copy to clipboard operation
kamal copied to clipboard

kamal proxy boot_config documentation quirks

Open claasz opened this issue 1 year ago • 1 comments

https://kamal-deploy.org/docs/commands/proxy/ has some quirks:

  • On the top it says kamal proxy boot_config <set|get|reset>, on the bottom kamal proxy boot_config <set|get|clear>
  • What's the difference between --no-publish, --skip-publish?
  • What's the unit of --log-max-size? Lines? Bytes?
  • --log-max-size: In the text it says "10m". So could be also "10k", "10", "10g"?
  • While I don't have a direct idea how to make it better, it should be made clear that "options" in the context of kamal proxy boot_config are not really optional
  • It's somehow confusing that some configurations are set in the standard kamal config.yml file, and some are set via kamal proxy boot_config. I guess there are good reasons for that, but I wish it would be more clear from the documentation

claasz avatar Dec 19 '24 09:12 claasz

  • It should be made clear that set requires at least one option, while get and reset don't accept any options (see #1310)

claasz avatar Jan 10 '25 16:01 claasz