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

Update workflow.md for "community projects" #830

Merged
merged 2 commits into from
Apr 3, 2024
Merged

Conversation

aprilmj
Copy link
Contributor

@aprilmj aprilmj commented Mar 26, 2024

Added a bit about community projects (formerly called "upstream", language improved by Erik).

Please check my description and edit as needed - I'm not positive that I completely understood the different types of community work, and don't want to use misleading language.

This should close issue #820

Added a bit about community projects (formerly called "upstream", language improved by Erik). 

Please check my description and edit as needed - I'm not positive that I completely understood the different types of community work, and don't want to use misleading language. 

This should close issue #820
@aprilmj aprilmj marked this pull request as ready for review March 26, 2024 17:49
Copy link
Member

@choldgraf choldgraf left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this - a quick thought on the details here:

My understanding is that the process for community initiatives is a bit different from our other initiatives, in that community initiatives define their task list in a separate issue or project board that we cross-reference from our "community initiative" issue. Do others agree that is missing from this description?

cross-functional/workflow.md Outdated Show resolved Hide resolved
@choldgraf
Copy link
Member

choldgraf commented Mar 26, 2024

Something else I'm noticing as I look at the initiatives board, where we've now got several community projects:

  1. It's not clear how those projects relate to the columns ("needs refinement" etc). Should we just assume that they perpetually stay in the "needs refinement" column, with the idea that each one will generate more specific/actionable initiatives that we then track independently on the board?
  2. Many of those projects have metadata embedded in their titles (specifically "PROJECT" and dates), which makes it hard to parse them. Could we instead add start date and end date fields to these boards, and use a "community initiative" field to categorize them? The dates could be something specific like the "period of performance" for contracts, or could be something team-driven like a time box for when we want to conclude an initiative.

For an example of 2, see this screenshot:

CleanShot 2024-03-26 at 11 40 57@2x

And this is the kind of structure I'm proposing (old version above and below, new version in between):

CleanShot 2024-03-26 at 11 43 22@2x

@aprilmj
Copy link
Contributor Author

aprilmj commented Mar 26, 2024

1. It's not clear how those projects relate to the columns ("needs refinement" etc). Should we just assume that they perpetually stay in the "needs refinement" column, with the idea that each one will generate more specific/actionable initiatives that we then track independently on the board?

That seems like a good place to start, based on what @jmunroe described in his Pythia thought experiment. We may realize we don't want to keep the long list in "needs refinement" once we're sure we have them all covered.

2. Many of those projects have metadata embedded in their titles (specifically "PROJECT" and dates), which makes it hard to parse them. Could we instead add `start date` and `end date` fields to these boards, and use a "community initiative" field to categorize them? The dates could be something specific like the "period of performance" for contracts, or could be something team-driven like a time box for when we want to conclude an initiative.

+1, that sounds like a great idea. I like that we're figuring out details as we go.

@choldgraf
Copy link
Member

Are there any objections to using board metadata for that information? In particular if @jmunroe or @colliand may have thoughts since (I think) they are the ones that chose that format for the PROJECT issues.

@choldgraf choldgraf requested a review from colliand March 26, 2024 20:20
@jmunroe
Copy link
Contributor

jmunroe commented Mar 26, 2024

I think shorter issue names and the use of labels/tags to store start and end dates makes sense. I've made those changes to the names.

@jmunroe
Copy link
Contributor

jmunroe commented Apr 3, 2024

I merged in Chris reformatting suggestion.

@jmunroe
Copy link
Contributor

jmunroe commented Apr 3, 2024

I think there is more to discuss about 'community projects' and how to integrate them into our on going work in defining initiatives. But there is nothing blocking merging in this PR since it already makes it clear that this this a work in progress.

@aprilmj I think you can click the 'Merge pull request' when you are ready to do so.

@aprilmj aprilmj merged commit 7b30e62 into main Apr 3, 2024
1 check passed
@aprilmj
Copy link
Contributor Author

aprilmj commented Apr 3, 2024

Thanks everyone! For future reference, what's this team's norm for documentation-related merges?

I was just thinking that I would be 100% ok with @jmunroe pushing the button while you were looking 👍

@choldgraf
Copy link
Member

We don't have a formal policy for merging documentation changes, but I think that following the team's decision making principles around bias towards action, I'd be comfortable encouraging people to "merge first if they think it's safe to try" unless there's something controversial or potentially wrong in there...

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

Successfully merging this pull request may close these issues.

3 participants