OAI / tools.openapis.org

A collection of open-source and commercial tools for creating your APIs with OpenAPI - Sourced from and published for the community
https://tools.openapis.org/
105 stars 30 forks source link

Build strategy for retrieving repository metadata #9

Closed SensibleWood closed 2 years ago

SensibleWood commented 2 years ago

User Story

As a system owner I want to ensure that metadata is retrieved judiciously and is not wasteful of machine time or resources.

Detailed Requirement

The majority of repositories referenced in the build will change very slowly (if they change at all). Using a "one-in, all-in" full build approach is therefore inappropriate. A more granular approach is required.

The following is suggested:

There is also a fair amount of "noise" in the data. For example:

The existing full build therefore needs to be split out as above and then reflected in the GitHub Actions config.

philsturgeon commented 2 years ago

I believe GitHub will spit out redirects on rename, which could be followed and updated to avoid things breaking when those redirects eventually stop working.

SensibleWood commented 2 years ago

Build schedule now implemented. New issue will be opened if tweaks to the schedule are required as we collect more data.