OAI / OpenAPI-Style-Guide

How to (and how not to) refer to the OAI in meetups, interviews, casual conversations, the settling of bar bets, and for conference presentations.
Apache License 2.0
210 stars 45 forks source link

Organize and consolidate name & logo usage guidelines, 3rd-party branding guidelines #16

Open tedepstein opened 6 years ago

tedepstein commented 6 years ago

This Style Guide now provides some guidelines for the use of the OpenAPI name in the branding of projects, tools, and organizations outside the OAI itself, and the use of logos resembling the OpenAPI logo in such projects.

However, I had a hard time finding guidelines for appropriate usage of the OpenAPI logo itself.

It turns out that the usage guidelines seem to be in three different places:

There's quite a bit of overlap across these pages. There are likely some inconsistencies. They don't seem to be cross-linked in a methodical way. A person looking at any one of these pages probably won't know to look at the others to get the full picture. They would reasonably assume that the guidelines they see are complete and definitive.

I think we should look at this carefully and try to make it more DRY, so there's exactly one authoritative source for information about appropriate use of the OpenAPI names and logos, along with the related third-party branding guidelines.