fossfoundation icon indicating copy to clipboard operation
fossfoundation copied to clipboard

Build foundation API lookups crossreference structure

Open ShaneCurcuru opened this issue 1 year ago • 3 comments

Users may come looking for a specific foundation, and we need to easily map them from whatever identifier they have to our explicit foundation id (i.e. the rootname of any .md file). Currently, openapi_builder.rb does this into the minimalist:

https://github.com/Punderthings/fossfoundation/blob/8f7d194877733a06127f2f24e2a1c7057b92b108/_foundations/list.json#L1C1-L6C5

One improvements is needed first, which also require updating the OpenAPI spec and openapi_builder.rb:

  1. Change the list.json to be a hash of hashes. The first is "id", which is the hash currently there now. Then add a "domain" hash, which is keyed to the domain name and just maps to the id.

Then, we need to poll users to ask: what other mappings might someone come to us with? For example, are there ever cases where a user may have some code repos, and they want to figure out if any Foundation claims those repos as their own? Or a user might have a legal name, or taxID for a foundation, and might want to look up our metadata on that foundation?

ShaneCurcuru avatar Nov 29 '24 12:11 ShaneCurcuru

For me, given the small number of records, I would love to just have all the data for all foundations represented in a single json file.

Also personally I'd probably look up by domain as the identifier.

andrew avatar Nov 29 '24 15:11 andrew

Rene Romero Verdugo Sr.

verdugo2025-sys avatar Jun 04 '25 02:06 verdugo2025-sys