Skip to content

Commit 511b0db

Browse files
committed
Add md file for 2024 draft of questions
1 parent 2b88512 commit 511b0db

File tree

1 file changed

+130
-0
lines changed

1 file changed

+130
-0
lines changed

2024_questions.md

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
1+
# Matplotlib User Survey
2+
3+
Information about user's experience with Matplotlib Python library to benefit documentation.
4+
5+
Welcome, and thank you for taking the time to participate in our survey! The Matplotlib team is conducting this survey to improve our community documentation. This survey should take approximately 15 minutes to complete. Your answers are completely confidential, and your participation is entirely voluntary. We value your feedback as it will enable us to make meaningful improvements.
6+
7+
## How often do you use the Matplotlib library?
8+
9+
Linear scale
10+
11+
- 1 - Never (do not or have not used Matplotlib)
12+
- 5 - Very often (~daily)
13+
14+
## How helpful has Matplotlib documentation been for your use case and tasks?
15+
16+
Linear scale
17+
18+
- 1 - Not helpful at all (never use documentation)
19+
- 5 - Very helpful (frequently and regularly use documentation)
20+
21+
## Select the best descriptions for how you value and use the Matplotlib documentation.
22+
23+
Checkboxes
24+
25+
- I use the docs to help me develop software.
26+
- I read the docs to help me learn about Python, data science, and visualization.
27+
- I read the docs to study for course work for an academic discipline (e.g. mathematics, economics, biology, history, etc.)
28+
- I use the docs to support my work in research projects (for example, industry, science, digital humanities, etc.)
29+
- I contribute to the docs and work with the community with other scientific Python projects.
30+
- Other
31+
32+
## How do you read Matplotlib API documentation or docstrings? Rank the following options from most likely to least likely.
33+
34+
Multiple choice grid, response required in each row
35+
36+
- Rows
37+
- Most likely
38+
- Neutral
39+
- Least likely
40+
- Columns
41+
- In a shell, raw text only
42+
- In an IDE with basic docstring rendering
43+
- On the Matplotlib documentation website
44+
45+
## How would you organize the importance of the following Matplotlib documentation categories?
46+
47+
Multiple choice grid, response required in each row
48+
49+
- Rows
50+
- Plot types (Data and distribution types)
51+
- User guide (Quickstart, FAQS, fundamentals, etc.)
52+
- Tutorials (Pyplot, image, lifecycle, etc.)
53+
- Examples (Demos and features)
54+
- Reference (API reference content)
55+
- Columns
56+
- Highest
57+
- Higher
58+
- Neutral
59+
- Lower
60+
- Lowest
61+
62+
## How would you rank the following Matplotlib documentation categories in terms of understandability?
63+
64+
Multiple choice grid, response required in each row
65+
66+
- Rows
67+
- Plot types (Data and distribution types)
68+
- User guide (Quickstart, FAQS, fundamentals, etc.)
69+
- Tutorials (Pyplot, image, lifecycle, etc.)
70+
- Examples (Demos and features)
71+
- Reference (API reference content)
72+
- Columns
73+
- Easiest
74+
- Easier
75+
- Neutral
76+
- More difficult
77+
- Most difficult
78+
79+
## What resources do you use to supplement your experience with Matplotlib documentation? Rank the choices from most preferred to least preferred.
80+
81+
Multiple choice grid, response required in each row
82+
83+
- Rows
84+
- Official documentation site
85+
- Short form videos (e.g. TikTok, YouTube Shorts, etc.)
86+
- Long form videos (e.g. Youtube videos, presentations, etc.)
87+
- Third party documentation
88+
- AI tools (e.g. ChatGPT, Claude, Gemini, etc.)
89+
- Columns
90+
- Most preferred
91+
- More preferred
92+
- Neutral
93+
- Less preferred
94+
- Least preferred
95+
96+
## When you arrive at a Matplotlib documentation page, how likely are you to go to another?
97+
98+
Linear scale
99+
100+
- 1 - Least likely (I have never thought about going to other pages.)
101+
- 5 - Most likely (I regularly navigate to other pages.)
102+
103+
## Given your response to the previous question, select the following reason(s) for your decision.
104+
105+
Checkboxes
106+
107+
- I found the information I needed.
108+
- I want to learn more about something.
109+
- Navigating documentation isn't for me.
110+
- Other
111+
112+
## What would you like to see change in Matplotlib's documentation?
113+
114+
Multiple choice grid
115+
116+
- Rows
117+
- Number of examples
118+
- Real-world data in content
119+
- Expositional language
120+
- Visual aids and graphics
121+
- Links to topics and resources
122+
- Update scheduling
123+
- Columns
124+
- Less/fewer
125+
- More
126+
- No change
127+
128+
## Thank you for completing the survey! Any additional feedback is welcome!
129+
130+
Paragraph, long answer text

0 commit comments

Comments
 (0)