Improve README with clear API reference, examples, and setup guides #6

Closed
priyanshu_bharti wants to merge 1 commits from priyanshu_bharti/vthumbs:docs/readme-pr-clean into master
Contributor

Summary

This PR improves the project documentation by rewriting the README to make it clearer, more complete, and developer-friendly.

What Changed

  • Added a clearer project overview and feature list
  • Expanded requirements for local development
  • Added Quick Start steps for running locally
  • Improved Docker setup instructions
  • Added an API Reference section for GET /thumbnail?url=VIDEO_URL
  • Documented supported query parameters
  • Added success and error response documentation
  • Added practical curl examples for success and failure cases
  • Added a clear license section

Why

The previous README was minimal and did not provide enough API details or examples for easy integration.

This update addresses Issue #4 by making onboarding and API usage straightforward for developers.

Testing

  • Verified Markdown structure and formatting
  • Checked that all requested sections are present
  • Confirmed command examples and endpoint references are consistent with current implementation

Related

## Summary This PR improves the project documentation by rewriting the README to make it clearer, more complete, and developer-friendly. ## What Changed - Added a clearer project overview and feature list - Expanded requirements for local development - Added Quick Start steps for running locally - Improved Docker setup instructions - Added an API Reference section for `GET /thumbnail?url=VIDEO_URL` - Documented supported query parameters - Added success and error response documentation - Added practical `curl` examples for success and failure cases - Added a clear license section ## Why The previous README was minimal and did not provide enough API details or examples for easy integration. This update addresses Issue #4 by making onboarding and API usage straightforward for developers. ## Testing - Verified Markdown structure and formatting - Checked that all requested sections are present - Confirmed command examples and endpoint references are consistent with current implementation ## Related - Closes #4
priyanshu_bharti added 1 commit 2026-04-15 20:25:42 +00:00
Owner

Less is more, I don't think this adds anything of value. A note about response format could be ok, but that would be a one line change.

Less is more, I don't think this adds anything of value. A note about response format could be ok, but that would be a one line change.
hodlbod closed this pull request 2026-04-15 21:21:30 +00:00

Pull request closed

Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: coracle/vthumbs#6