Add items to API Specification Weekly Report

Tl;dr

Help us at API Specification Toolbox curate and tag content featuring OpenAPI, JSON Schema, AsyncAPI, GraphQL and gRPC and we'll promote your Twitter account in our weekly newsletter.

Background

The API Specification Weekly Report is a project that seeks to track 5 specifications and their ecosystems. We are focused on OpenAPI, JSON Schema, AsyncAPI, GraphQL and gRPC. And we collect content from the following categories on each of the 5 specifications.

• People (those who are prominent in producing content, contributing to specs, building tools or implementing the specs.)
• Adoption (companies, technologies or tools that adoption a spec)
• Issues (selected from the Github repos of the specs)
• Discussions (selected from the Github repos of the specs)
• News (curated from Hacker News, newsletters, funding announcements, or blogs)
• Tweets (Twitter of course :)
• Videos (YouTube or anywhere else)
• Tools
• Events (upcoming conferences, meetups, or webinars related to a spec)
• NewFunding (new funding announcements that involve adoption of the specs or its tools)

These are the categories we've been tracking for the past few months and give a broad view of current and important developments across the ecosystems of these five specifications.

Now we would like to open up this process to the wider community so that we all can highlight the important content for each of OpenAPI, JSON Schema, AsyncAPI, GraphQL and gRPC. Afterall, a thought eyes are better than two when capturing notable occurances from a fairly broad corner of the tech space.

This document will help you with the low friction, easy process of adding your thoughts or choices to a valuable resource for the API sector.

Steps to Participate

• Step 1. Follow our API Specification Toolbox account on Twitter.
• Step 2. Read some of the tweets to get a feel for what we tweet and how we use hashtags # to associate a piece of content with a spec or specs and the categories.
• Step 3. @ mention the API Specification Toolbox account when you tweet content to add to the weekly report.
• Step 4. When you add the hashtags to help us categorize the content we will feature your Twitter account in our newsletter.

That's it. It's simple and will become second nature to your tweet process once you've posted a few @ mentions.

NOTE: Some content will be suitable for multiple specs and more frequently multiple categories. Just be sure to add a hashtag for each spec or category tag you want to use.

If you have any questions or suggestions, DM us on Twitter.

Examples