zio-http icon indicating copy to clipboard operation
zio-http copied to clipboard

Roll out comprehensive documentation for ZIO HTTP

Open jdegoes opened this issue 1 year ago • 27 comments

The documentation can be patterned on http4k, and provide a variety of sections, including:

  • Introduction
  • Concepts
    • Routing
    • Request Handling
    • Server
    • Client
    • Middleware
    • Endpoint
  • Tutorials
    • Your First ZIO HTTP App
    • Deploying a ZIO HTTP App
    • Testing Your ZIO HTTP App
  • How-to-guides
    • (This should be based off the list of topics at http4k, but should also include ZIO HTTP use cases around Endpoint, middleware, etc.)
  • Reference
    • API Docs
    • Server backend
    • Websockets
    • JSON Handling
    • Metrics
    • Request Logging
    • (etc.)
  • Performance
  • FAQ

The documentation must be built with existing tooling, include examples that are checked for compile-ability with mdoc, and must be copyedited for correct spelling and grammar (possibly with the help of AI tooling).

The overall volume of content would be similar to, but less than, http4k's documentation website.

jdegoes avatar May 17 '23 08:05 jdegoes

/bounty $2000

jdegoes avatar May 17 '23 08:05 jdegoes

💎 $2,000 bounty • ZIO

Steps to solve:

  1. Start working: Comment /attempt #2198 with your implementation plan
  2. Submit work: Create a pull request including /claim #2198 in the PR body to claim the bounty
  3. 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 bountyShare on socials

Attempt Started (GMT+0) Solution
🔴 @daveads May 23, 2023, 10:35:15 AM WIP
🔴 @feliciien May 31, 2023, 11:39:13 PM WIP
🔴 @harshbisle Jun 4, 2023, 10:26:07 AM WIP
🔴 @wright-eric Dec 26, 2023, 5:04:48 AM WIP
🔴 @varshith257 Apr 17, 2024, 1:05:39 PM #2838
🔴 @promisingcoder Jul 18, 2024, 1:23:05 PM WIP

algora-pbc[bot] avatar May 17 '23 08:05 algora-pbc[bot]

/attempt #2198

harshbisle avatar May 17 '23 21:05 harshbisle

@harshbisle: Please complete your work on zio/zio-cli#184 before attempting another issue.

algora-pbc[bot] avatar May 18 '23 10:05 algora-pbc[bot]

Yes, I will be finishing the zio-cli doc this week and eventually hop on to this issue.

harshbisle avatar May 18 '23 10:05 harshbisle

/attempt #2198

daveads avatar May 23 '23 10:05 daveads

@daveads: Reminder that in 7 days the bounty will become up for grabs, so please submit a pull request before then 🙏

algora-pbc[bot] avatar May 30 '23 10:05 algora-pbc[bot]

Note: The user @daveads is already attempting to complete issue #2198 and claim the bounty. If you attempt to complete the same issue, there is a chance that @daveads will complete the issue first, and be awarded the bounty. We recommend discussing with @daveads and potentially collaborating on the same solution versus creating an alternate solution.

algora-pbc[bot] avatar May 31 '23 23:05 algora-pbc[bot]

@daveads hello? can we work together?

feliciien avatar Jun 03 '23 16:06 feliciien

/attempt #2198 Hey @daveads and @feliciien, can I join? What's your progress, BTW?

harshbisle avatar Jun 04 '23 10:06 harshbisle

i send you friend request

feliciien avatar Jun 04 '23 13:06 feliciien

/attempt #2198

feliciien avatar Jun 05 '23 19:06 feliciien

@feliciien: Reminder that in 7 days the bounty will become up for grabs, so please submit a pull request before then 🙏

algora-pbc[bot] avatar Jun 07 '23 23:06 algora-pbc[bot]

@harshbisle: Reminder that in 7 days the bounty will become up for grabs, so please submit a pull request before then 🙏

algora-pbc[bot] avatar Jun 11 '23 10:06 algora-pbc[bot]

/attempt #2198

Options

wright-eric avatar Dec 26 '23 05:12 wright-eric

/attempt #2198

Options

varshith257 avatar Apr 17 '24 13:04 varshith257

@khajavi @jdegoes Is it ready to work?

varshith257 avatar Apr 19 '24 13:04 varshith257

@varshith257: Reminder that in 7 days the bounty will become up for grabs, so please submit a pull request before then 🙏

algora-pbc[bot] avatar Apr 24 '24 13:04 algora-pbc[bot]

@jdegoes Need your guidance here

varshith257 avatar Apr 24 '24 13:04 varshith257

The bounty is up for grabs! Everyone is welcome to /attempt #2198 🙌

algora-pbc[bot] avatar May 01 '24 13:05 algora-pbc[bot]

@khajavi Let's wait for the response of @daveads for a while and others or I can proceed further to make progress on this if it doesn't get any response on this issue from daveads.

Seems others dropped from long ago with the response of @daveads making progress from a year.

varshith257 avatar May 05 '24 10:05 varshith257

@khajavi Let's wait for the response of @daveads for a while and others or I can proceed further to make progress on this if it doesn't get any response on this issue from daveads.

Seems others dropped from long ago with the response of @daveads making progress from a year.

Decided to break down the PR into smaller pull request so it would be easy for reviewers to review it and then point to them when am finally done... something in that order

daveads avatar May 05 '24 16:05 daveads

cc: @khajavi I am working alone and will submit PR soon :)

varshith257 avatar May 06 '24 06:05 varshith257

/attempt #2198

Options

promisingcoder avatar Jul 18 '24 13:07 promisingcoder

Hey @promisingcoder, I have done some cool progress on it and waiting for maintainers reviews. It could be duplicate of efforts again if you get started with this. So I think you can have a look at other open issues :)

varshith257 avatar Jul 18 '24 13:07 varshith257

@promisingcoder: Reminder that in 7 days the bounty will become up for grabs, so please submit a pull request before then 🙏

algora-pbc[bot] avatar Jul 25 '24 13:07 algora-pbc[bot]

The bounty is up for grabs! Everyone is welcome to /attempt #2198 🙌

algora-pbc[bot] avatar Aug 01 '24 13:08 algora-pbc[bot]