Skip to content

[Governance] Phase 1: Issue Templates#417

Merged
emmambd merged 3 commits intogoogle:masterfrom
MobilityData:311-templates-issues
Jan 4, 2024
Merged

[Governance] Phase 1: Issue Templates#417
emmambd merged 3 commits intogoogle:masterfrom
MobilityData:311-templates-issues

Conversation

@emmambd
Copy link
Collaborator

@emmambd emmambd commented Dec 15, 2023

📓 Context

As part of Phase 1 of Epic Issue #413, MobilityData proposes to add Issue Templates as one of the solutions to help alleviate the high barrier to entry that was rendered evident to us during multiple outreach efforts in 2023.

💡 Proposed Solution

We propose to implement the following templates and links:

  • Specification Change: Guide the contributor to describe the problem and showcase the proposed solution.
  • Ask a Question: Guide the contributor to provide sufficient information for better answers.
  • Links: Redirect contributors to valuable resources like Slack, GTFS.org, and the Google Groups
  • The template page also provides the option to publish a blank issue at the bottom of the page.

ℹ️ Additional Information

As the governance changes in the next months, we can expect to change or add templates accordingly.

  • When editorial and "smaller" changes are defined, we can expect to create templates for those cases.

We welcome the community to review the proposal and provide some feedback. We hope to adopt this change as an editorial change and fast track its adoption if there is a clear consensus in the comments.

@emmambd emmambd changed the title docs: issue templates add docs: add issue templates Dec 15, 2023
@emmambd emmambd linked an issue Dec 15, 2023 that may be closed by this pull request
@emmambd emmambd requested a review from eliasmbd December 15, 2023 20:00
@emmambd emmambd changed the title docs: add issue templates [Governance] Phase 1: Issue Templates Dec 15, 2023
Copy link
Collaborator

@eliasmbd eliasmbd left a comment

Choose a reason for hiding this comment

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

Reviewed the content. Looks good to me! We could use some additional feedback by the community on the template titles and content. Is the structure adequate and does it fulfill the purpose described above?

Copy link
Collaborator

@isabelle-dr isabelle-dr left a comment

Choose a reason for hiding this comment

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

I have made a small fix to config.yml, you can see what this PR would look like for this repo here.

I've left a few minor comments inline. Thank you!

@emmambd emmambd merged commit eee97f7 into google:master Jan 4, 2024
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.

chore: add issue templates

3 participants