Skip to content

Commit b06fef0

Browse files
committed
Huw goes brr
1 parent 9bce592 commit b06fef0

30 files changed

+539
-688
lines changed

_toc.yml

Lines changed: 62 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -4,35 +4,65 @@
44
format: jb-book
55
root: pages/intro
66
parts:
7-
- caption: Procedures
8-
chapters:
9-
- file: pages/procedures/getting-started
10-
- file: pages/shifts/shifts
11-
sections:
12-
- file: pages/shifts/shift-organization
13-
- file: pages/shifts/shift-sign-up
14-
- file: pages/shifts/shift-tasks
15-
- file: pages/shifts/payment
16-
- file: pages/procedures/procedures
17-
sections:
18-
- file: pages/procedures/queries
19-
- file: pages/procedures/auto-replies
20-
- file: pages/procedures/arranging-meetings
21-
- file: pages/procedures/time-allocation
22-
- file: pages/procedures/file-storage
23-
- file: pages/procedures/tracker
24-
sections:
25-
- file: pages/procedures/ticket-updates
26-
- file: pages/procedures/update-tracker
27-
- file: pages/procedures/meetings
28-
- file: pages/procedures/roadshow
29-
- caption: Resources
30-
chapters:
31-
- file: pages/resources/other-services
32-
- caption: For managers
33-
chapters:
34-
- file: pages/managers/recruitment
35-
- file: pages/managers/new-shifters
36-
sections:
37-
- file: pages/managers/contracts
38-
- file: pages/managers/access
7+
- caption: Getting started
8+
chapters:
9+
- file: pages/Getting_started/roles
10+
- file: pages/Getting_started/getting-started
11+
- file: pages/Getting_started/payment
12+
- caption: Ask-JGI Shifts
13+
chapters:
14+
- file: pages/Ask-JGI_shifts/shift-organization
15+
- file: pages/Ask-JGI_shifts/shift-sign-up
16+
- file: pages/Ask-JGI_shifts/meetings
17+
- caption: Ask-JGI Queries
18+
chapters:
19+
- file: pages/Ask-JGI_queries/Ask-JGIqueries
20+
- file: pages/Ask-JGI_queries/ticket-updates
21+
- file: pages/Ask-JGI_queries/tracker
22+
- file: pages/Ask-JGI_queries/time-allocation
23+
- file: pages/Ask-JGI_queries/arranging-meetings
24+
- caption: Signposting and other services
25+
chapters:
26+
- file: pages/resources/other-services
27+
28+
29+
30+
31+
32+
# Old TOC
33+
34+
# format: jb-book
35+
# root: pages/intro
36+
# parts:
37+
# - caption: Procedures
38+
# chapters:
39+
# - file: pages/procedures/getting-started
40+
# - file: pages/shifts/shifts
41+
# sections:
42+
# - file: pages/shifts/shift-organization
43+
# - file: pages/shifts/shift-sign-up
44+
# - file: pages/shifts/shift-tasks
45+
# - file: pages/shifts/payment
46+
# - file: pages/procedures/procedures
47+
# sections:
48+
# - file: pages/procedures/queries
49+
# - file: pages/procedures/auto-replies
50+
# - file: pages/procedures/arranging-meetings
51+
# - file: pages/procedures/time-allocation
52+
# - file: pages/procedures/file-storage
53+
# - file: pages/procedures/tracker
54+
# sections:
55+
# - file: pages/procedures/ticket-updates
56+
# - file: pages/procedures/update-tracker
57+
# - file: pages/procedures/meetings
58+
# - file: pages/procedures/roadshow
59+
# - caption: Resources
60+
# chapters:
61+
# - file: pages/resources/other-services
62+
# - caption: For managers
63+
# chapters:
64+
# - file: pages/managers/recruitment
65+
# - file: pages/managers/new-shifters
66+
# sections:
67+
# - file: pages/managers/contracts
68+
# - file: pages/managers/access

images/meetingminutes.png

30 KB
Loading
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# How queries work
2+
3+
## 1. Researchers email their queries
4+
5+
Researchers email their queries to ask-jgi@bristol.ac.uk.
6+
7+
## 2. Auto reply
8+
9+
An [automatic email](auto-replies) is sent to the querier,..
10+
This email asks the querier for additional details (e.g. description of aim and problem, description or excerpt of data) and letting them know to expect a response within the next few days.
11+
The automatic reply looks something like:
12+
```
13+
Thank you for your Ask-JGI enquiry. Your query will be picked up by a member of the Ask-JGI team soon.
14+
15+
In the meantime please reply to this email to provide any
16+
supplementary information to your question.
17+
Make sure you include this phrase somewhere in the email:
18+
{AskJGI-110}.
19+
This helps us to track how the AskJGI service is used.
20+
21+
Suggested additional information:
22+
1. Your research question
23+
2. Any relevant papers / draft manuscripts etc.
24+
3. A description of your data (and a sample if you can send it)
25+
4. Any relevant analysis scripts/code that you have produced so far.
26+
27+
```
28+
Note the {AskJGI-110} in the text above. The number corresponds to
29+
the Ask-JGI ticket number (110 in this example), which increments with each newly received
30+
query. This number acts as a unique identifier for the email thread,
31+
which is then used to open a new ticket in the Ask-JGI tracker. All
32+
subsequent emails that contain this same identifier will be associated
33+
with the newly created ticket (so that the ticket gets updated with
34+
each new email in the thread).
35+
You can read about how to deal with duplicate tracker IDs in the [next section](duplicates).
36+
37+
## 3. Ask-JGI student on shift shares the query on Teams
38+
39+
The Ask-JGI student on shift will share the query in the Ask-JGI **Teams channel**, and will either:
40+
- confirm that they intend to reply to the query, or
41+
- ask whether anyone else is available to do so.
42+
43+
Noting the new query in the Teams channel gives those not on shift the opportunity to collaborate on the query if it is of interest to them, or falls within their own area of expertise.
44+
Likewise, the person on shift may not feel that they have the appropriate level of expertise in the relevant area.
45+
If this is the case it is also possible to ask for advice from the rest of the team on how to proceed, or to request support to answer the query.
46+
47+
### Buddy System
48+
49+
Some queries might be quite general and anyone from the team can help. Sometimes there will be specific queries that require/are more suitable to be handled by someone with certain expertise. Whilst we want to provide a good support service, we want to avoid Ask-JGI students being pigeonholed into their expertise and give them the space to learn new skills.
50+
51+
You can do this as a sort of buddy system, with one person taking the lead and the other attending meetings to support (perhaps to take notes). It means that in the meeting, the more confident can take the lead, but then the “buddy” can do the task with guidance from the lead. This lets the Ask-JGI team upskill and also increases the spread of skillsets across the team so that we don’t end up with the same people handling all the same queries.
52+
53+
## 4. Assign yourself on the tracker
54+
55+
Once it has been agreed who will pick up the query, that team member is responsible for assigning the task to themselves on the [here](tracker), and recording information on the and faculty of the querier, and allocating relevant tags.
56+
Instructions on how to fill out tickets on the Ask-JGI tracker can be found [here](tracker).
57+
58+
## 5. Respond to the query
59+
60+
The Ask-JGI team member responsible for the query will respond to the querier to either answer their question or to [arrange a meeting](arranging-meetings) to discuss further.
61+
62+
**It is important to reply to the latest email in the email thread (which includes the Ask-JGI automatic response) so that the Ask-JGI ticket number is included in the continuing email thread**.
63+
64+
This ensures that the same tracker ticket is updated as the email thread evolves.
65+
66+
You can read more about how to set up meetings and what to do in meetings [here](arranging-meetings).
67+
68+
## 6. Keep the tracker up to date!
69+
70+
The Ask-JGI team member should use the notes section of their query ticket on the Ask-JGI [tracker](tracker) to record the status and current actions from their query.
71+
72+
## 7. Resolve the query
73+
74+
Once the query has been resolved, the ticket on the tracker should be marked as resolved.
75+
76+
```{note}
77+
You can store any files related to your queries [here](https://uob.sharepoint.com/:f:/r/teams/grp-jeangoldinginstituteteam/Shared%20Documents/Ask-JGI/Projects?csf=1&web=1&e=rjQdqF).
78+
Remember to give any folders an informative name, so future shifters can access your files. On the tracker, each query comes with its own unique ID number, including this number in the folder name can be useful if we get queries from the same people in the future.
79+
```
80+
81+
82+
83+
84+
85+
86+
87+

pages/procedures/arranging-meetings.md renamed to pages/Ask-JGI_queries/arranging-meetings.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,9 @@
33

44
It is common to receive queries in the mailbox that require a short
55
meeting with the querier in order to clarify their question, their
6-
needs, and their expectations. The Ask-JGI student who has been
6+
needs, and their expectations. If the query isn’t answered by a quick email response (which is usually a signposting or very quick code fix), you should arrange a meeting. The Ask-JGI student who has been
77
assigned a query is responsible for setting up this meeting.
88

9-
Please see instructions below on the following:
10-
- [How to set up meetings](meeting-setup)
11-
- [Following up after a meeting](meeting-followup)
12-
139
(meeting-setup)=
1410
## How to set up meetings
1511

@@ -38,8 +34,7 @@ number) and suggest some times that you are able to meet.
3834
> XXX
3935
> {AskJGI-XXX}
4036
41-
- or, you can ask permission to book a meeting in their calendar at a time where their calendar shows them as being free.
42-
For example:
37+
- or, you can ask permission to book a meeting in their calendar at a time where their calendar shows them as being free. For example:
4338

4439
> Dear XXX,
4540
>
@@ -60,14 +55,24 @@ number) and suggest some times that you are able to meet.
6055
> XXX
6156
> {AskJGI-XXX}
6257
58+
## What to do in a meeting
59+
Meetings can be arranged online or in person depending on what works best for the participants. You should start by briefly introducing yourself both of your background relevant to data science (e.g. I’m a PhD student working in Statistics to do with healthcare) and that you work as one of the Ask-JGI PhD students.
60+
61+
We’ve found that it can be good to measure expectations early on. If you tell the person that you’re an expert in something and then you can’t help, it’s not a good look. If you tell someone you’re familiar with the area but not an expert, then they’ll be pleasantly surprised if you can answer their question immediately but they won’t be put out if you can’t immediately solve the problem. We do not expect Ask-JGI students to have deep knowledge in all topics of data science and neither should the people we do work for!
62+
63+
Before you get into the technical requirements of the problem, it’s important to state the limitations on the workflow, in particular that each Ask-JGI query has at most a day (~7 hours) of free support, which includes this meeting. Setting this expectation early can save the awkwardness later of having to say no to requests.
64+
65+
Once you’ve done this, you can get to the query. How you do this is down to more personal preference and what the query involves. If you’ve booked a meeting, you’re likely going to have a bit of a back and forth discussion where you asking clarifying questions to address this problem. Whilst you do this, you should take notes of the discussion and any extra details you learn about the query.
66+
67+
If the query will be more involved, you can agree on how much/what work will be done and any restraints (e.g. timeline) on that work. Sometimes, the fact that the queries are limited in time mean that researchers might have to decide how to best make use of Ask-JGI to support them.
68+
6369
(meeting-followup)=
6470
## Following up after a meeting
6571

6672
Once you have had a consultation meeting with a querier you should begin to compose a
6773
summary email to them as soon as possible. Doing this sooner rather
6874
than later helps to ensure that everything is fresh in your mind,
69-
making it less likely that you will forget something. Use any notes
70-
that you have taken during your meeting to help you.
75+
making it less likely that you will forget something. You should take notes during the meeting and use these to help you write this email.
7176

7277
Sending summary emails are important:
7378
- It is helpful to repeat your key takeaways from the meetings to make
@@ -99,8 +104,7 @@ When composing your summary emails try to include the following:
99104
the querier, include a timeline for when the next contact is
100105
expected.
101106

102-
If in any doubt, ask for help! The Ask-JGI coordinator and JGI Data
103-
Scientists will be happy to review any email before you send it.
107+
If in any doubt, ask for help! Your peers, the Ask-JGI coordinator and the Ask-JGI lead will be happy to review any email before you send it.
104108

105109
```{note}
106110
Remember to update the Ask-JGI tracker after a meeting to reflect what has

pages/Ask-JGI_queries/queries.md

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
(arranging-meetings)=
2+
# Arranging meetings
3+
4+
It is common to receive queries in the mailbox that require a short
5+
meeting with the querier in order to clarify their question, their
6+
needs, and their expectations. If the query isn’t answered by a quick email response (which is usually a signposting or very quick code fix), you should arrange a meeting. The Ask-JGI student who has been
7+
assigned a query is responsible for setting up this meeting.
8+
9+
Please see instructions below on the following:
10+
- [How to set up meetings](meeting-setup)
11+
- [Following up after a meeting](meeting-followup)
12+
13+
(meeting-setup)=
14+
## How to set up meetings
15+
16+
If meeting with the querier seems to be the most productive next
17+
step, reply to their email (including the tracking identification
18+
number) and suggest some times that you are able to meet.
19+
20+
- If you use your university Outlook calendar, you can either suggest that they book a meeting directly into your calendar at a time convenient for them.
21+
For example:
22+
23+
> Dear XXX,
24+
>
25+
> Many thanks for getting in contact with Ask-JGI. Would it be useful
26+
> to have an introductory Teams call (30 minutes, say) to go over your
27+
> query in a little more detail and see how we might be able to
28+
> support?
29+
>
30+
> I can also explain how we might go about assisting and work out
31+
> which of our team would be best placed to help you.
32+
>
33+
> I’ve cc’d my email address into this email – if you can get access to
34+
> my calendar then I’m happy for you to schedule something at a time that
35+
> suits you.
36+
>
37+
> Kind regards,
38+
> XXX
39+
> {AskJGI-XXX}
40+
41+
- or, you can ask permission to book a meeting in their calendar at a time where their calendar shows them as being free. For example:
42+
43+
> Dear XXX,
44+
>
45+
> Many thanks for getting in contact with Ask-JGI. Would it be useful
46+
> to have an introductory Teams call (30 minutes, say) to go over your
47+
> query in a little more detail and see how we might be able to
48+
> support?
49+
>
50+
> I can also explain how we might go about assisting and work out
51+
> which of our team would be best placed to help you.
52+
>
53+
> If you'd like me to set up a meeting then please let me know. I
54+
> could do tomorrow afternoon or the following morning, for example?
55+
> Alternatively I can try to find a slot in your calendar if it is up
56+
> to date?
57+
>
58+
> Kind regards,
59+
> XXX
60+
> {AskJGI-XXX}
61+
62+
## What to do in a meeting
63+
Meetings can be arranged online or in person depending on what works best for the participants. You could start by briefly introducing yourself both of your background relevant to data science (e.g. I’m a PhD student working in Statistics to do with healthcare) and that you work as one of the Ask-JGI PhD students.
64+
65+
We’ve found that it can be good to measure expectations early on. If you tell the person that you’re an expert in something and then you can’t help, it’s not a good look. If you tell someone you’re familiar with the area but not an expert, then they’ll be pleasantly surprised if you can answer their question immediately but they won’t be put out if you can’t immediately solve the problem. We do not expect Ask-JGI students to have deep knowledge in all topics of data science and neither should the people we do work for!
66+
67+
Before you get into the technical requirements of the problem, it’s important to state the limitations on the workflow, in particular that each Ask-JGI query has at most a day (~7 hours) of free support, which includes this meeting. Setting this expectation early can save the awkwardness later of having to say no to requests.
68+
69+
Once you’ve done this, you can get to the query. How you do this is down to more personal preference and what the query involves. If you’ve booked a meeting, you’re likely going to have a bit of a back and forth discussion where you asking clarifying questions to address this problem. Whilst you do this, you should take notes of the discussion and any extra details you learn about the query.
70+
71+
If the query will be more involved, you can agree on how much/what work will be done and any restraints (e.g. timeline) on that work. Sometimes, the fact that the queries are limited in time mean that researchers might have to decide how to best make use of Ask-JGI to support them.
72+
73+
(meeting-followup)=
74+
## Following up after a meeting
75+
76+
Once you have had a consultation meeting with a querier you should begin to compose a
77+
summary email to them as soon as possible. Doing this sooner rather
78+
than later helps to ensure that everything is fresh in your mind,
79+
making it less likely that you will forget something. You should take notes during the meeting and use these to help you write this email.
80+
Sending summary emails are important:
81+
- It is helpful to repeat your key takeaways from the meetings to make
82+
sure that everyone attending the meeting has left on the same page.
83+
- Having a written record from the meeting is helpful for any future
84+
follow-up with querier (particularly if the follow-up is handled by
85+
another team member).
86+
87+
When composing your summary emails try to include the following:
88+
- restate the purpose of the meeting, the key questions that the
89+
querier needed help with.
90+
- if there was some level of ongoing support or action agreed, make
91+
clear in this email at what level that the JGI will be able to
92+
support this.
93+
- sometimes these meetings help to clarify exactly what the querier is
94+
asking, and there might be several questions mixed up in
95+
there. Break the query down into its constituent parts in the email.
96+
- review what you discussed, using subject headings if appropriate to
97+
separate the different aspects of the problem.
98+
- link to any resources that you discussed during the meeting, or that
99+
you think might be relevant.
100+
- finish the email by stating the next steps, e.g.:
101+
- perhaps you agreed that the querier will take away this
102+
information and get back to Ask-JGI if they have any follow up
103+
questions.
104+
- perhaps you agreed that the querier will send you some data to
105+
look at, or perhaps you already have the data.
106+
- if there is further action already anticipated, from either you or
107+
the querier, include a timeline for when the next contact is
108+
expected.
109+
110+
If in any doubt, ask for help! Your peers, the Ask-JGI coordinator and the Ask-JGI lead will be happy to review any email before you send it.
111+
112+
```{note}
113+
Remember to update the Ask-JGI tracker after a meeting to reflect what has
114+
happened and what is expected to happen next (if any follow-up is expected).
115+
Update the status field to indicate whether the query is
116+
resolved or still in progress.
117+
```
118+
119+
(time-allocation)=
120+
## Time allocation for queries
121+
Although Ask-JGI team members have up to one day (7 hours) to spend on Ask-JGI
122+
queries, it is expected that most queries should take half a day or less
123+
(approx. 1-3 hours). If you have a query that you think might take longer than
124+
this can be discussed with the Ask-JGI shift coordinator.
125+
126+
```{tip}
127+
Remember that the
128+
Ask-JGI Teams channel is there for you to ask for help and to discuss
129+
your queries.
130+
```
131+
132+
Shifters are responsible for recording honestly the time that is spent
133+
on each Ask-JGI query. This time can include time spent preparing for
134+
and participating in meetings with Ask-JGI "customers," as well as any
135+
time spent researching the query and preparing email responses.
136+
137+
Once a query has been resolved the Ask-JGI team member should note the
138+
number of hours spent on the query on the tracker ticket.

0 commit comments

Comments
 (0)