Edit page Add new page

GovPress support

GovPress Support provides day-to-day support for our existing GovPress clients. Support is co-ordinated by our Account Manager, but issues raised in support will be resolved by a team of colleagues.

Responding to client needs is the responsibility of the whole team, and so everyone will touch support work at some point.

The rest of this page describes how GovPress Support is organised, and will be especially useful to anyone who is working in support for the first time.

Ticket workflow #

How tickets cascade through support levels (reified as Zendesk views)

Tickets arrive in Zendesk and are automatically assigned (by customer email address) to the GovPress support triage group. Colleagues in this group will triage the ticket by adding all available metadata and setting the Priority for the ticket. Colleagues will also ask for any obvious clarifications that we need from the client. At this point, Support colleagues will make a judgement about how long the ticket will take to resolve, and re-assign the open ticket to someone appropriate in the relevant Zendesk group, which are:

Note that if a task takes longer than expected, colleagues on GovPress 1st or 2nd line support will want to cascade the work down to the next group. Conversely, if a ticket has to be dropped, it can be returned to the GovPress Support Triage group to be triaged again.

Ticket statuses #

When you respond to a ticket on Zendesk, there are a number of options for “submitting” your response. These are ticket statuses. We use ticket statuses slightly differently than Zendesk intended. This is our current practice:

Ticket attributes #

A single Zendesk ticket with an SLA applied to it (1) and its type and priority set (2)

Once tickets have been triaged, they should have their priority and type attributes set (2 in the screenshot above). Setting the priority of a ticket will also determine the service level agreement (SLA) which is applied to it (1). The requester will have been sent an automated email which will tell them which SLA has been applied to their request. We aim to meet the SLA for every ticket, so please prioritise tickets which are closest to breaching their SLA.

Adding Trello cards to tickets #

 Zendesk Trello integration

You can automatically create a Trello card for the appropriate board from within Zendesk. Click on the “bento box” menu icon labelled Apps on the right of the ticket (1), and fill in the highlighted form (2) to create a new ticket. Once the ticket has been created, you will see its id appear with the other ticket attributes (3).

Preparing to work in Support #

Access to our systems infrastructure #

On Support, you are likely to need access to more of our infrastructure than you would normally use in day to day development work. If you have never worked on the support rota before, in the Support and Maintenance Backlog, please make a copy of the card called Add a new developer to the support rota (copy me!) to keep track of the work that you (and others) need to do to gain access to all of our systems, which means you should have completed your staff vetting.

These are the systems you will need access to:

The documentation here describes how to actually access a running server or instance. If you need to find the highest id in the current user data bags, you can run:

grep uid *.json | cut -d \" -f 4 | sort | tail -1

From the data_bags/users directory in the Chef repository.

Software to install #

Please ensure that you have the following installed before your start your rotation:

And make sure you have the govpress-developer-docs repo and ops/docs repo bookmarked, along with the Project Knowledgebase on AirTable.

Please also ensure that you have the incident.io app installed in Slack, that you can access the Dashboard with single-sign-on, and that you have completed the tutorial (type /incident tutorial in Slack to do this).

Starting a 2nd line support rotation #

When you start your rotation, you need to be added to the GovPress 2nd line support group in Zendesk. Please ask someone in the Maintenance and Support Team or a Delivery Lead to do this for you, and to remove the last person on the rota, if they are still in the group.

During your rotation #

Whilst you are working in Support, please attend the Maintenance and Support stand-ups and add yourself to the Trello boards we use, which are the Support and Maintenance Backlog and the Week in Progress. This will help you with context for what is going on in 2nd line support, and the other work around our infrastructure.

Please join the support channels on Slack, which contain automated notifications from Zendesk:

And these channels which will give you information about our infrastructure and incidents:

You are responsible for delivering all the tickets in the GovPress 2nd line support group. If you think that any of these will take more than around 0.5 days of development work, they should be scoped and ideally moved into a sprinting team. In this case, please talk to the relevant Tech Lead and Delivery Lead, in the first instance.

At the start of your rotation, it is a good idea to read through all of the tickets in the GovPress 2nd line support group and note any particular deadlines that clients might have. As you go through the day, try to work through tickets in priority order and look out for any that are close to a breach of our SLAs (which should be resolved first).

As you look through each ticket, write down any thoughts you have or any progress you have made as internal notes, which are not seen by clients. This is useful for other colleagues you may be working with and for anyone who needs to go back to this ticket for context about the client or project.

Please also regularly check the Suspended tickets view in Zendesk, which sometimes holds tickets for GovPress.

If you run out of 2nd line tickets to work on #

Whilst you are on Support, 2nd line work should keep you busy through the day and this will be your first priority. Work from any sprinting teams you might have been working with will be picked up by other colleagues.

If you run out of tickets to resolve, please ask GovPress 1st line support if they need help. If you still have nothing to do, please go through the Weekly tasks swimlane in the Week in Progress, which lists the jobs that need completing weekly. Each card there should have a clear explanation of how the relevant job should be done. If those explanations aren’t clear, please ask on the #dxw-govpress-maintenance-and-support Slack channel.

Ending a 2nd line support rotation #

Before you finish your time on Support, please make sure that any unfinished work you have, or any context you may have is passed on to the next person on the rota. Please ensure that you:

Last updated: 17 May 2024 (history)