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

Adding draft SLA to issue-management.md file #163

Merged
merged 15 commits into from
Jul 31, 2019

Conversation

thomashchan1
Copy link
Contributor

Added draft SLA for issues and PRs in CONTRIBUTING.md

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
Copy link
Member

@iredelmeier iredelmeier left a comment

Choose a reason for hiding this comment

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

Overall, I have some concerns about putting the SLA into CONTRIBUTING.md instead of somewhere in the community repo, most likely as SIG membership requirements.

I believe that putting these sorts of requirements on non-core participants will deter potential contributors and other newcomers to the product. On the other hand, moving them into (eg) SIG membership requirements may help us preserve the general goal of addressing end-user issues quickly.

CONTRIBUTING.md Outdated Show resolved Hide resolved
@thomashchan1 thomashchan1 changed the title Adding draft SLA to CONTRIBUTING.md file Adding draft SLA to issue-management.md file Jul 23, 2019
@thomashchan1
Copy link
Contributor Author

thomashchan1 commented Jul 23, 2019

@AloisReitbauer, @bogdandrutu, @c24t, @reyang, @SergeyKanzhelev, @songy23, @rghetia and/or @yurishkuro, please review the updated SLA changes, namely:

  1. moved changes to a new issue-management.md file instead of in contributing.md
  2. simplified the triage documentation from OC: https://github.com/census-instrumentation/opencensus-specs/blob/master/triage-process.md and also from backlog management PR: WIP: basic backlog management community#52, keeping priorities and labels to the minimum.

Copy link
Member

@songy23 songy23 left a comment

Choose a reason for hiding this comment

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

Still not sure about the "URGENT" label vs. priority labels but this looks a good starting point.

issue-management.md Show resolved Hide resolved
issue-management.md Outdated Show resolved Hide resolved
issue-management.md Outdated Show resolved Hide resolved
issue-management.md Outdated Show resolved Hide resolved
Copy link
Member

@yurishkuro yurishkuro left a comment

Choose a reason for hiding this comment

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

The precise SLOs make sense if there is a way to measure them and have accountability. I would love to have tooling for that. Otherwise how do we, as a project, know if we're anywhere near those SLOs?

issue-management.md Outdated Show resolved Hide resolved
Copy link
Member

@reyang reyang left a comment

Choose a reason for hiding this comment

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

LGTM.

@rghetia
Copy link
Contributor

rghetia commented Jul 23, 2019

LGTM

issue-management.md Show resolved Hide resolved
@thomashchan1
Copy link
Contributor Author

thomashchan1 commented Jul 24, 2019

Thanks, @reyang and @songy23

@yurishkuro would love to find ways to measure these via automation. Will see if I can find anything that we can use. Anyone else has suggestions, please send them to our Gitter channel or comment here. In the interim, will need to depend on all of us to identify gaps, politely call them out so that we can address them and get better together.

Copy link
Member

@c24t c24t left a comment

Choose a reason for hiding this comment

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

Some superficial comments, but the content LGTM.

issue-management.md Show resolved Hide resolved
issue-management.md Show resolved Hide resolved
- For smaller or internal changes: 1 approval from a different company.
- For `URGENT` issues:
- Collaborator: please provide initial assessment of the issues to OP ASAP or
within 1 business day, whichever is earlier.
Copy link
Member

Choose a reason for hiding this comment

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

"ASAP or within X" seems to have the same logic as "up to X% off or more" -- it could describe any number.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The intention here is to highlight the request for quick response while stating the upper limit. Let me know your thoughts.

Copy link
Member

Choose a reason for hiding this comment

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

How about something like this?

"Please provide an initial assessment of the issue within 1 business day. URGENT issues are time-sensitive. Collaborators should prioritize the assessment and responses to review comments above other work and respond as quickly as possible."

"As quickly as possible" still feels fishy to me since this is what SLAs are meant to solve.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Understood @c24t . Given this is community based and not really the same as enforceable within one company, suspect this is as good as we can get in terms of prescribing the intent. One question is while this sounds better and more descriptive as well, do you (or anyone else) feel comfortable duplicating this, with some minor adjustment, 2 other times for URGENT issue SLA vs the existing shorter versions? For other minor comments above, I am planning to resolve them to move things along. Let me know otherwise or feel free to re-open if you have strong feelings on those. Thanks again for spending the time to provide input.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@c24t let me know your thoughts on this. Would like to get this merged soon. Thanks in advance.

issue-management.md Outdated Show resolved Hide resolved
issue-management.md Show resolved Hide resolved
issue-management.md Outdated Show resolved Hide resolved
issue-management.md Outdated Show resolved Hide resolved
issue-management.md Show resolved Hide resolved
issue-management.md Outdated Show resolved Hide resolved
@c24t c24t mentioned this pull request Jul 24, 2019
@carlosalberto carlosalberto merged commit cf30f0f into open-telemetry:master Jul 31, 2019
SergeyKanzhelev pushed a commit to SergeyKanzhelev/opentelemetry-specification that referenced this pull request Feb 18, 2020
* Update CONTRIBUTING.md
* Create issue-management.md
* Update issue-management.md

Co-Authored-By: Chris Kleinknecht <libc@google.com>
TuckTuckFloof pushed a commit to TuckTuckFloof/opentelemetry-specification that referenced this pull request Oct 15, 2020
carlosalberto pushed a commit to carlosalberto/opentelemetry-specification that referenced this pull request Oct 31, 2024
* Update CONTRIBUTING.md
* Create issue-management.md
* Update issue-management.md

Co-Authored-By: Chris Kleinknecht <libc@google.com>
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.

10 participants