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

decision(issues): add draft decision about how to create issues and prs #242

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

simskij
Copy link
Member

@simskij simskij commented Dec 3, 2024

A first draft on our rules for creatinmg issues and prs.

Feedback much appreciated!

@simskij simskij requested a review from a team as a code owner December 3, 2024 13:15
- Issues of the story/enhancement type should have a title that describes the work to be done in
the _imperative modus_, i.e "Add a bip to the bop", rather than "We should add a bip to the bop"
- Issues of the bug type should have a title that describes the bug occuring, written in
_modus ponens_, i.e "When <condition> then <outcome>".
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
_modus ponens_, i.e "When <condition> then <outcome>".
_modus ponens_, i.e "When <condition> then <outcome>". When necessary, add a description of why the outcome is bad and what would you expect 'good' to look like.

- Issues of the story/enhancement type should have a title that describes the work to be done in
the _imperative modus_, i.e "Add a bip to the bop", rather than "We should add a bip to the bop"
- Issues of the bug type should have a title that describes the bug occuring, written in
this format: "When <condition> then <outcome>".
Copy link
Contributor

Choose a reason for hiding this comment

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

It's surpisingly hard to describe complex scenarios that way. Just started writing a bug named

"When charm is related to grafana-agent without a connected tracing backend then cos-agent exposes an inaccessible tracing URL" which doesn't sound easy to say in a status update. I think it makes sense as a guideline, but not necessarily a rule.

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