Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OpenRefine ecosystem map #325

Open
magdmartin opened this issue Apr 16, 2024 · 1 comment
Open

OpenRefine ecosystem map #325

magdmartin opened this issue Apr 16, 2024 · 1 comment

Comments

@magdmartin
Copy link
Member

magdmartin commented Apr 16, 2024

Issue created from this conversation #303 (comment). The diagram discussed is available on this branch: https://github.com/OpenRefine/openrefine.org/blob/ecosystem_page/src/pages/ecosystem.md


In this diagram I struggle a bit to understand what is a node and what is an edge.
The type of concepts that go into nodes doesn't seem to be uniform to me. For instance there are nodes about:

  • "user support" (an activity)
  • "support forum" (an online space)
  • "advisory committee" (a group of people)

Are those meant to always refer to a specific group of people? Maybe the phrasing of the nodes could be adapted to make that clearer ("translators" instead of "translation", and so on)

Then I have the same sort of problem with edges. What does an edge mean?

  • "reports to"? (such as in "project manager" - "advisory committee")
  • "is included in"? (such as in "reconciliation services" - "third-party developers")
  • "communicates with"? (such as in "advisory committee" - "CS&S")

And then it's not clear to me why certain edges are there and others not. For instance, why is there an edge between "funding partners" and "advisory committee" but not between "funding partners" and "project manager"? Why an edge between "code of conduct committee" and "advisory committee"?

Also I have the feeling that the light blue box is meant to circle where the OpenRefine project starts and ends - but then do we need the central "OpenRefine project" node? Can't that be a label added to the box itself?

Originally posted by @wetneb in #303 (comment)

@magdmartin
Copy link
Member Author

I aimed to use the graph to provide a comprehensive overview of the project. This will help new members understand the different contributor groups and the scope of the project (who is responsible for what). The main goal is to keep it simple and easy to read for new community members, while also directing them to relevant resources if they want to learn more.

My goal is to include the following contributor types:

  • Development team (including designer, developer, release manager.)
  • Third-party developers
  • Governance (with the Advisory Committee, Project Manager, and CS&S)
  • Funders
  • Relationship with our user community (support, documentation, translation) and highlighting the contributor doing training, advocacy, and support within their community. This is currently worded as is on the page Each community provides advocacy, training, and support activities via mediums relevant to its members, with little coordination between them.

An earlier, more complex version is available on the forum. Feedback at the time was that it was too detailed and not intelligible.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant