zio-http Configuration of ZIO HTTP

What is not easy to do right now? There is no single source (website, markdown...) where one can find out about all config options in ZIO HTTP. One needs to inspect the code for the various configs we have e.g. zio.http.ConnectionPoolConfig.config or zio.http.Server.Config.config or zio.http.netty.Config.config.

Describe the solution you'd like We should auto-generate all config options (probably in the build process) into a markdown page entitled Configuration and with the help of zio.config. That works already:

val config = zio.http.ConnectionPoolConfig.config // compose with other configs
val docs = generateDocs(config).toTable.toGithubFlavouredMarkdown // generateDocs comes from zio.config
println(docs) // prints auto-generated content directly from inspecting the config instance

Also we could generate an example config file including default values from all given configs.

Why is it important? Easier configuration, user friendlyness and always up to date docs

Additional context zio.config: https://zio.dev/zio-config/dive-into-zio-config#documentations-using-config

Sep 08 '23 08:09 TomTriple

/bounty $100

Sep 26 '23 16:09 jdegoes

💎 $100 bounty • ZIO

Steps to solve:

Start working: Comment /attempt #2431 with your implementation plan
Submit work: Create a pull request including /claim #2431 in the PR body to claim the bounty
Receive payment: 100% of the bounty is received 2-5 days post-reward. Make sure you are eligible for payouts

Thank you for contributing to zio/zio-http!

Add a bounty • Share on socials

Attempt	Started (GMT+0)	Solution
🔴 @guersam	Sep 30, 2023, 8:42:25 AM	WIP
🔴 @vivasvan1	Oct 25, 2023, 9:46:43 AM	WIP
🔴 @jaimin001	Dec 29, 2023, 11:34:06 PM	WIP
🔴 @pragmaxim	Apr 13, 2024, 11:14:32 AM	WIP