Landscape Report Template

[kinlane]

This is a template for the weekly report across five of the leading API specifications, providing a snapshot of these communities that can be used to develop awareness, quantify the scope of, and increase engagement within these communities.

People

Identify one person each week who is doing interesting things within each of these formats.

• OpenAPI
  • Name:
  • Description:
  • Twitter:
  • LinkedIn:
  • Github:
• AsyncAPI
  • Name:
  • Description:
  • Twitter:
  • LinkedIn:
  • Github:
  • JSON Schema
  • Name:
  • Description:
  • Twitter:
  • LinkedIn:
  • Github:
  • GraphQL
  • Name:
  • Description:
  • Twitter:
  • LinkedIn:
  • Github:
  • gRPC
  • Name:
  • Description:
  • Twitter:
  • LinkedIn:
  • Github:

Adoption

Identify one company or organization that has adopted one of each of these formats (head start available here: OpenAPI, AsyncAPI, JSON Schema)

• OpenAPI
  • Name:
  • Description of Use:
  • URL:
• AsyncAPI
  • Name:
  • Description of Use:
  • URL:
  • JSON Schema
  • Name:
  • Description of Use:
  • URL:
  • GraphQL
  • Name:
  • Description of Use:
  • URL:
  • gRPC
  • Name:
  • Description of Use:
  • URL:

The Beat

Make sure we are covering the beat each week and surfacing relevant information from across the communities.

Any interesting issues? (OpenAPI, AsyncAPI, JSON Schema. GraphQL, gRPC)

• OpenAPI
  • Title:
  • Description:
  • URL:
• AsyncAPI
  • Title:
  • Description:
  • URL:
  • JSON Schema
  • Title:
  • Description:
  • URL:
  • GraphQL
  • Title:
  • Description:
  • URL:
  • gRPC
  • Title:
  • Description:
  • URL:

Any interesting discussions? (OpenAPI, AsyncAPI, JSON Schema, GraphQL, gRPC)

• OpenAPI
  • Title:
  • Description:
  • URL:
• AsyncAPI
  • Title:
  • Description:
  • URL:
  • JSON Schema
  • Title:
  • Description:
  • URL:
  • GraphQL
  • Title:
  • Description:
  • URL:
  • gRPC
  • Title:
  • Description:
  • URL:

Any interesting news?

• OpenAPI
  • Title:
  • Description:
  • URL
• AsyncAPI
  • Title:
  • Description:
  • URL:
  • JSON Schema
  • Title:
  • Description:
  • URL:
  • GraphQL
  • Title:
  • Description:
  • URL:
  • gRPC
  • Title:
  • Description:
  • URL:

Any interesting tweets?

• OpenAPI
  • Title:
  • Description:
  • URL:
• AsyncAPI
  • Title:
  • Description:
  • URL:
  • JSON Schema
  • Title:
  • Description:
  • URL:
  • GraphQL
  • Title:
  • Description:
  • URL:
  • gRPC
  • Title:
  • Description:
  • URL:

Any interesting videos?

• OpenAPI
  • Title:
  • Description:
  • URL:
• AsyncAPI
  • Title:
  • Description:
  • URL:
  • JSON Schema
  • Title:
  • Description:
  • URL:
  • GraphQL
  • Title:
  • Description:
  • URL:
  • gRPC
  • Title:
  • Description:
  • URL:

Any interesting tools?

• OpenAPI
  • Title:
  • Description:
  • URL:
• AsyncAPI
  • Title:
  • Description:
  • URL:
  • JSON Schema
  • Title:
  • Description:
  • URL:
  • GraphQL
  • Title:
  • Description:
  • URL:
  • gRPC
  • Title:
  • Description:
  • URL:

Scope

Quantifying the scope of the communities week by week.

Twitter Followers

Measuring the activity that occurs across Twitter

• OpenAPI: 0
• AsyncAPI: 0
• JSON Schema: 0
• GraphQL: 0
• gRPC: 0

Github Scope

Measuring the activity occurring across Github

• OpenAPI
  • Github Repo Forks: 0
  • Github Repo Watch: 0
  • Github Repo Stars: 0
• AsyncAPI
  • Github Repo Forks: 0
  • Github Repo Watch: 0
  • Github Repo Stars: 0
• JSON Schema
  • Github Repo Forks: 0
  • Github Repo Watch: 0
  • Github Repo Stars: 0
• GraphQL
  • Github Repo Forks: 0
  • Github Repo Watch: 0
  • Github Repo Stars: 0
• gRPC
  • Github Repo Forks: 0
  • Github Repo Watch: 0
  • Github Repo Stars: 0

Stack Overflow Questions

Measuring the activity on Stack Overflow using number of overall questions.

• OpenAPI : 0
• AsyncAPI: 0
• JSON Schema: 0
• GraphQL: 0
• gRPC: 0

[meenakshi-dhanani]

We could probably remove the Stack Overflow section from the template, since Stack Overflow doesn't display the total count of questions but only the 500 results in a paginated fashion. Also, it's difficult to count since there are tags that include these tags eg. gRPC-protobuff, gRPC, gRPCio ,etc. @kinlane If you think it makes sense, I could raise a PR with the modified template.

[meenakshi-dhanani]

Regarding the template, wouldn't it be more useful as a reader to see all these updates grouped as specs. The specs as I view them complement each other, and as audience I would be interested in the specs I'm using or plan to use, so viewing updates group by spec would be easier to scroll through and learn than a comparison between the specs I personally think. @kinlane ?