You are browsing a read-only backup copy of Wikitech. The live site can be found at wikitech.wikimedia.org

User talk:Alex Paskulin/API catalog: Difference between revisions

From Wikitech-static
Jump to navigation Jump to search
imported>Nikki Nikkhoui
(misread one of your questions - clarified my response)
imported>Alex Paskulin
(Alex Paskulin moved page User talk:Alex Paskulin/API catalog to Talk:API catalog: Moving out of user page)
 
Line 1: Line 1:
== First draft questions ==
#REDIRECT [[Talk:API catalog]]
 
* The [https://backstage.io/docs/features/software-catalog/descriptor-format#speclifecycle-required-1 Backstage docs] list a few values for the lifecycle field. Do we have a list of the values we want to use? The [https://api.wikimedia.org/wiki/Community/API_guidelines#API_Lifecycle API guidelines] have design, develop, deploy, etc., but those seem more like project phases?
* The [https://backstage.io/docs/features/software-catalog/descriptor-format#spectype-required Backstage docs] list the spec type and definition as required fields. What should we do for APIs without a spec?
* The [https://backstage.io/docs/features/software-catalog/descriptor-format#specowner-required-1 spec.owner field] seems to require an entity to be set up in Backstage. Should we go through and set these up for each team, or is it ok for them to be 404 links? ([https://backstage.toolforge.org/catalog/default/group/platform%20engineering%20team Example])
--[[User:Alex Paskulin|Alex Paskulin]] ([[User talk:Alex Paskulin|talk]]) 00:03, 1 December 2021 (UTC)
 
:* I actually think the suggested <code>experimental</code>, <code>production</code>, <code>deprecated</code> on Backstage are better terms, my opinion would be to use those 3 if you agree? I don't know if "Lifecycle" on the API guidelines was intended to mean the same thing, it may be worth renaming the API guidelines section.
:* All APIs can have a spec type (if we want to again go with Backstage suggested <code>service</code>, <code>website</code>, or <code>library</code> terms. but for those that may not have a spec definition, we could create a script that will generate a bare-bones default API spec file that can be loaded as the definition. Just enough values to be considered a "valid" OpenAPI spec. What do you think?
:* I think we should definitely set these up for each team! OR....better yet find a way to generate them from some central source...like querying LDAP! [[User:Nikki Nikkhoui|Nikki Nikkhoui]] ([[User talk:Nikki Nikkhoui|talk]]) 23:46, 2 December 2021 (UTC)

Latest revision as of 18:17, 12 January 2022

Redirect to:

Retrieved from "https://wikitech-static.wikimedia.org/w/index.php?title=User_talk:Alex_Paskulin/API_catalog&oldid=585890"