Skip to content

Commit 176bf14

Browse files
committed
Fix typos and formatting
1 parent 9b944d4 commit 176bf14

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

docs/html/ux-research-design/guidance.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ Below is a brief guide to building a survey for pip:
8181
</li>
8282
<li>
8383
<strong>Design your questions</strong><br>
84-
<ol>
84+
<ul>
8585
<li>
8686
Limit the number of questions you ask to avoid a low response rate. A good rule of thumb is: 3-4 questions about the specific topic, 2-3 questions about users level of experience / what they use Python or pip for.<br>
8787
When asking about years of experience use the following groupings as options:
@@ -100,7 +100,8 @@ Below is a brief guide to building a survey for pip:
100100
<li>
101101
Use <a href="https://en.wikipedia.org/wiki/Open-ended_question">open questions</a> to learn about reasoning. If you are using a lot of closed questions in your survey, it is useful to include some open questions to "fish" for less expected answers - e.g. asking a user "why?" they chose a particular option
102102
</li>
103-
</ol>
103+
</ul>
104+
</li>
104105
<li>
105106
<strong>Pilot your survey and modify it based on feedback</strong><br>
106107
This could be as simple as sharing it with 1-2 people to see if it makes sense.
@@ -171,7 +172,7 @@ See also:
171172

172173
Interviews are a great way to have more in-depth conversations with users to better understand or explore a topic. Unlike surveys, they are not a great way to understand overall patterns, as it is hard to engage with a large number of people due to the time involved. It can be particularly useful to plan around conferences and events as a way to connect with many users in a more informal setting.
173174

174-
#### Designing Interviews for pip
175+
#### Designing Interviews
175176

176177
As with surveys, it's important to establish what you want to learn before you begin.
177178

@@ -184,7 +185,7 @@ Below is a brief guide to running an interview for pip:
184185
<strong>Write your script</strong><br>
185186
This should include an introduction that sets the scene for the participant, explaining what the interview is about, how you (or observers) will take notes, how long it will take, how their feedback will be used (and shared) and any other pointers you want to share.<br>
186187
Next, design your questions. Limit the number of questions, so that you have enough time to cover key points and the interview does not run for too long. Like in surveys, a good rule of thumb is 2-3 questions about users' level of experience, and what they use Python/pip for, plus 3-4 questions about the specific topic.<br>
187-
There are [four different types of interview questions](https://simplysecure.org/resources/qualitative_interviewing.pdf):
188+
There are <a href="https://simplysecure.org/resources/qualitative_interviewing.pdf">four different types of interview questions</a>:
188189
<ol>
189190
<li>
190191
<em>Descriptive</em> — This type of question gives you concrete, specific stories and details. It also helps your interviewee "arrive" at the interview, resurfacing their relevant experiences and memories. E.g.<br>

0 commit comments

Comments
 (0)