GitHub

OpenAPI.Tools is a community-driven project from APIs You Won’t Hate that aims to provide the best resources for OpenAPI users. We are a small team of volunteers that work on this project in our free time. We are always looking for ways to improve the project and make it more useful for the community.

Tool submission guidelines

We encourage all efforts in the OpenAPI ecosystem, and none of these tools are easy to create and maintain. That said, we don’t want to be an exhaustive list of every single tool out there. OpenAPI.Tools is a curated list, which aims to help people find modern, reliable tooling, that’s of as high quality as we can reasonably hope for.

Our focus on high-quality tooling means we cannot accept every tool that would like to be listed here, at least not right away. Submissions must align with the following guidelines:

  • Real-world use: there should be evidence that people are using it, perhaps through package downloads, GitHub stars, or other means
  • Testable: submissions should be released, and there should be a way of testing it so we can validate it works
  • Relevant: all submissions must relate to the OpenAPI ecosystem and abide by its Code of Conduct
  • Terminology: descriptions and language should follow the OpenAPI Glossary

🛠 Adding New Tools

To add a new tool to the project, you need to create a new markdown file in the src/content/tools/ directory. Each tool should have its own file.

  1. Navigate to the src/content/tools/ directory.
  2. Create a new markdown file. The file name should be the name of the tool, with spaces replaced by hyphens (e.g., my-new-tool.md).
  3. In the new markdown file, add the necessary information about the tool. Here’s a basic template you can use:
---
name: 'Tool Name'
description: 'A brief description of the tool.'
categories:
  - docs
  - sdk-generators
  - code-validators
  - servers
  - mocking-tools
languages: { 'Language1': true, 'Language2': false }
link: 'https://toolwebsite.com'
repo: 'https://github.com/example/example.git'
openApiVersions:
  v2: false
  v3: true
  v3_1: true
  v4: true
---

## Overview

Provide an overview of the tool here.

## Features

List the main features of the tool here.

## Usage

Explain how to use the tool here.

See /src/content/categories/ for the list of available categories. If the tool fits into multiple categories, you can add them to the categories list. Make the categories you list match the file name of existing categories from the /src/content/categories/ directory.

If you think we’re missing a category, feel free create an issue or open a pull request to add a new category and we’ll review it!

  1. Fill in the information for the tool. Make sure to replace 'Tool Name', 'A brief description of the tool.', 'https://toolwebsite.com', 'The category of the tool', and the content of the sections with the appropriate information.
***