@rossbar made this comment in 2020; not sure if it needs to be addressed this year.

Of the 1236 survey participants, 490 (40%) have contributed to at least one open source software project...
Source: https://rossbar.github.io/numpy-survey-results/content/contributions.html

Here are my calculations:
Sample size - 1037
Yes - 490
490 ~ 47% of 1037

Please note that Q3.2 specifically omits NumPy:
Q3.2 Have you ever contributed to any open source project before, excluding NumPy? Yes/No
Without mentioning it, your statement is not accurate as NumPy IS an open source project too.

I put placeholders in the code "[INSERT LINK]" where we will need to insert links to the high-level report, public use files, or survey once we have the appropriate links. This will have to get done more towards the end. There are places for links on the intro page, in the Priorities section, and in the intro of the Future section.

Check these two pages for 2020-specific info and update accordingly. Ideally we'd be able to just update the wording for 2021, but if that's too much of a change we can always copy the files so that there is a 2020 and a 2021 version.

Thanks @stephaniem2014 for catching this!

A lot of f"{value} ({100 * value / denom}:1.0f%)" in the md files - consider a helper function to make all these shorter.

• The OSS & NumPy-specific contribution questions (i.e. Q3.X & Q4.X) should have the same categories. For example, the options for Q3.4 has the following options: ['Code maintenance and development' 'Community coordination' 'DevOps' 'Developing educational content & narrative documentation (e.g. tutorials)' 'Fundraising' 'Other (please specify)' 'Project management' 'Responding to GitHub issue' 'Translating content' 'Website design and development' 'Writing technical documentation] whereas the corresponding question for NumPy (Q4.2) has the following options: ['Community coordination' 'Educational materials development' 'Fundraising and grant writing' 'Marketing' 'Other (please specify)' 'Programming' 'Web development' 'Writing documentation']

• Potential issue with conditional for Q4.7 (What prevents you from contributing to NumPy) - only ~10 responses out of 600+ potential respondents

It would be nice if we could order the categories in some of the bar charts in the Contribution section. Specifically, we could order from largest bar to smallest, for the "non-NumPy contributors" group, for the bar charts in the following subsections:

1. OSS Contributions
2. Types of Contributions
3. How did contributors get their start?

The size of the "click to show/hide" tables are still large even when collapsed. First example of this is the "Language Preference" table in the Community section. I believe all of these types of tables throughout have the same issue.

• Increased font size
• Custom colors?

@rossbar We need to create a separate page for the About section for each report as partnerships will vary year from year. What do you think would be the best solution for this?

The inability to see the rendered output (i.e. what the website will look like) for changes proposed in PRs makes the review process more cumbersome. It would be an improvement to set up a CI service to build/preview the static site for PRs so that the rendered changes can be evaluated.

The tricky part: building the site requires the data, which is private. Investigate a solution based on gpg + github secrets.

Many of the questions have this already, but not all, (e.g. Motivations in contributions.md)

flatten is defined separately in mentorship and contributions.

A listing of things to tackle from the most recent review. @InessaPawson please feel free to add anything I've missed.

• Add glossary of terms | See #14
• Modify plot color scheme. Branded colors + orange first | See #13
• Reorganize menubar items | See #21
  • Note: it would be a lot of effort to reorganize as the data loading for each notebook reflects the sequential structure of the underlying survey data. Existing sections could be renamed easily enough.
• Add acknowledgements | See #15
• Add methodology section
• Move narrative text from google doc to site source | See #18

After some discussion I think we settled on serving the site at https://numpy.org/user-survey-2020. I think this requires a Cloudflare redirect (looking into that this week), and a CNAME file in the gh-pages branch of this repo.

In certain bar charts, there are doubles of each category and the text have quotes that need to be stripped. I believe this issue exists in a few of the bar charts in the Contributions section and in two of the bar charts in the Usage section. Example in attached photo.

There are also some bar charts that have categories for missing values. I think this only exists in the Contribution section bar charts.

Of the respondents who expressed interest in contributing to NumPy, most (75%) were interested in contributing to the source code and 47% expressed interest in developing education content or technical documentation.
Source: https://rossbar.github.io/numpy-survey-results/content/contributions.html

This is my analysis for Q4.9 (see below). 29% expressed their interest in contributing to the source code and 36% – would like to help with educational content or technical documentation.

... while 88 (7%) have contributed to NumPy specifically.
Source: https://rossbar.github.io/numpy-survey-results/content/contributions.html

Here are my calculations:
Sample size - 1008
Yes - 88
88 ~ 8.73% of 1008