DEV Community

Discussion on: What are some examples of open-source projects with great READMEs?

Collapse
 
liyasthomas profile image
Liyas Thomas • Edited

I spend a lot of time in Postwoman's readme.

GitHub logo hoppscotch / hoppscotch

👽 A free, fast and beautiful API request builder used by 75k+ developers. https://hoppscotch.io

hoppscotch.io logo

A free, fast and beautiful API request builder

Helps you create requests faster, saving precious time on development - Subscribe

Travis Build Status GitHub release Website Contributions welcome Financial Contributors on Open Collective Donate on PayPal Chat on Telegram Chat on Discord Tweet


Built with ❤︎ by
liyasthomas and
contributors




Chat: Telegram, Discord

Donate: GitHub Sponsors, Open Collective, Patreon, PayPal

Screenshot1
Table of contents

Features

❤️ Lightweight: Crafted with minimalistic UI design.

⚡️ Fast: Send requests and get/copy responses in real-time.

Methods:

  • GET - Retrieve information about the REST API resource
  • HEAD - Retrieve response headers identical to those of a GET request, but without the response body.
  • POST - Create a REST API resource
  • PUT - Update a REST API resource
  • DELETE - Delete a REST…




Collapse
 
sarensw profile image
Stephan Arenswald

I do like READMEs that have this hero-like header part as shown in this example. It looks professional and I don't have the feeling that this is just made for experts.

Collapse
 
radiomorillo profile image
Stephanie Morillo

Thanks for sharing, Liyas—indeed, it's very detailed.

Did you take inspiration from other projects? How did you cmake the decision to structure your README the way you did?

Collapse
 
liyasthomas profile image
Liyas Thomas

I remember finding a public gist which had most of the sections for a README boilerplate. I don't have the link to it with me now.

Collapse
 
goxr3plus profile image
GOXR3PLUS STUDIO

Wow that's a really great project!