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 service objectives page #143

Merged
merged 13 commits into from
Jun 16, 2022
Merged

Update service objectives page #143

merged 13 commits into from
Jun 16, 2022

Conversation

choldgraf
Copy link
Member

@choldgraf choldgraf commented May 13, 2022

This provides some updates about our service objectives page to sharpen the language and make it easier to glance through. It is inspired in part from some recent conversations we had with @colliand, @balajialg, @ericvd-ucb, and the DataHub team.

Would love any feedback or thoughts on how this could be improved or made more clear.

I've also opened an update to our team support processes here, and would love feedback: 2i2c-org/team-compass#422

@balajialg
Copy link

balajialg commented May 14, 2022

@choldgraf Thanks for sharpening the service objectives. I wonder whether quantifying support response time for outages could be reassuring for partners. IMHO, response time within 24 business hours can be challenging for mission-critical tasks like responding to outages (24 business hours ~ 3 working days?). Should support response time vary dynamically for such occurrences? My 2 cents - It will be a valuable support practice to segment tickets based on the priority of the issue (like you already do) and allocate a faster response time (say 8 business hours) for mission-critical tasks.

I know there are practical constraints at your end for making such assurances. I do think such assurances in the future would be valuable for community representatives and support folks. Or you could tie this to your pricing model. Curious to hear your thoughts!

@choldgraf
Copy link
Member Author

That's a good idea - I think this matches our team goals as well, will update the PR here

@choldgraf
Copy link
Member Author

I've made a few updates to these documents per @balajialg and others' suggestions, let me know what y'all think!

Our goal is to be more rapid in responding, communicating, and resolving support requests during incidents.
Our ability to meet these objectives will depend on the times they are reported relative to the working hours of our support team.

- We will triage and respond to Incidents within 8 working hours.
Copy link
Member

Choose a reason for hiding this comment

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

We should say something here about how this is an upper bound but we generally try to respond before that.

Comment on lines +32 to +40
(objectives:intentional-downtime)=
### Intentional downtime

In some cases there may be intentional downtime for the infrastructure that we run.
For example, if we need to undergo major maintenance of infrastructure transitions.

- We will communicate with communities before any intentional downtime.
- We will aim for downtime windows that happen outside of heavy usage.
- We will communicate with communities when the expected downtime is over.
Copy link
Member

Choose a reason for hiding this comment

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

I would add a "To be refined" admonition to this section too as we haven't yet defined how this communication and scheduling would happen, e.g., 2i2c-org/team-compass#423

about/service-objectives.md Outdated Show resolved Hide resolved
yuvipanda and others added 2 commits May 30, 2022 14:52
Co-authored-by: Sarah Gibson <[email protected]>
Copy link
Member

@yuvipanda yuvipanda left a comment

Choose a reason for hiding this comment

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

I think this is good to merge once https://github.com/2i2c-org/docs/pull/143/files#r884550187 is addressed.

@choldgraf
Copy link
Member Author

choldgraf commented Jun 3, 2022

Thanks for the feedback and suggestions all, I've taken another pass and I think have addressed everybody's concerns above! I tried to clarify "a working day" and also softened the language around response times that we promise.

Copy link
Contributor

@damianavila damianavila left a comment

Choose a reason for hiding this comment

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

LGTM now.

@choldgraf choldgraf merged commit dd8e784 into main Jun 16, 2022
@choldgraf choldgraf deleted the support branch June 16, 2022 14:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
No open projects
Archived in project
Development

Successfully merging this pull request may close these issues.

5 participants