unkeyed / unkey

Open source API management platform
https://go.unkey.com
Other
4k stars 468 forks source link

chore: consider changing API naming convention to Application #504

Closed CITGuru closed 11 months ago

CITGuru commented 11 months ago

Preliminary Checks

Description

There's confusion regarding referring applications and APIs. They seem to be the same thing, however, they are referenced in many places as either API or Application.

Apps or applications are a better standard name for what API is today.

This would require Schema, API, and content changes in order to achieve this entirely, so might need to weigh the future benefits of this

Screenshot 2023-11-15 at 19 25 10
perkinsjr commented 11 months ago

APIs could be

Production Development Staging

They could also be

Application 1 Application 2 Application 3

They could also be

API 1 API 2 API 3

It's not as cut and dry as "Applications versus APIs" Which is why it's named as Applications at the Top heading and APIs referenced on the side bar underneath. We stuck with this model but it depends on the use case of Unkey and currently we have a mixture of all three.

CITGuru commented 11 months ago

I think it should be opinionated when it comes to the environment/staging tag. You can create multiple application each on representing different staging/environment