search

PhilanthropyDataCommons / service

A project for collecting and serving public information associated with grant applications
GNU Affero General Public License v3.0
8 stars 2 forks source link

Rename `Organization` to `ChangeMaker` #1117

Open slifty opened 1 month ago

slifty commented 1 month ago

We currently store an entity called Organization (as opposed to Proposal)

On call today @kfogel suggested we should make this more specific: ChangeMaker

This seems like a reasonable idea, especially as we are about to add new entity types that represent "organizations" (in a real world sense) and they are distinct from Organization/ChangeMaker.

Implementing this change would mean adjusting our endpoints in a breaking way; that's OK to do, but it is something we should try to only do once if we can help it. The bottom line question to me is: "is ChangeMaker a forever term?"

kfogel commented 1 month ago

Authoritative answer: "changemaker", with capitalization like a regular English word. Internally we may use the "CM" abbreviation sometimes, but the public-facing word is "changemaker".

(Source: Julie Hoffman in Slack just now, replying to Karl: "changemaker with capitalization like any other English word. thanks!!")

slifty commented 1 month ago

I am going to take this on now since it impacts the work for #1116

slifty commented 1 month ago

Short term update on this -- I'm pausing for a moment just to make 100% final sure we want Changemaker (vs, say, applicant).

The considerations here is that we don't want a term that might not last, since this has impact on API endpoints and data beyond just being used internally in a lot of ways. I expect to hear back tomorrow!

In the meantime, back to provenance 😅

jmergy commented 1 month ago

I would lean more to keep it Organization for now. Not something I would think we should try and mess with, for now, since changemaker is not super-universally known/understood.

kfogel commented 1 month ago

@jmergy What about Applicant or Grantseeker? (This would only show up in internal code and in the API; it has no effect on what's presented on the front end.)

IMHO, Organization has become too generic. We now have other organizational entities represented in the PDC, such as funders and data providers. So we probably don't want to use "organization" internally for changemaker -- those other things are organizations too, so it would be confusing: why do we use the generic word "organization" for one kind of organization, while using more-specific words for other kinds of organizations?

We could solve this with Applicant or Grantseeker (technically, the letter is the most accurate, since not every grant happens as the result of an application process, but I think either one is fine).

Thoughts?