<div dir="ltr"><div>HI Maja,</div><div><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Sep 16, 2019 at 12:14 PM Maja Gwozdz <<a href="mailto:maja.gwozdz.mkg33@gmail.com">maja.gwozdz.mkg33@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi everyone,<div><br></div><div>I'm currently working on improving the SciPy documentation during the Google Season of Docs. One of my projects is about a user survey. The basic idea is to get (documentation) feedback from SciPy users and try to improve our docs accordingly. </div><div><br></div><div>It'd be great if you could take a look at the survey form and say if you have any comments that could help me. You can access it here: <a href="https://docs.google.com/forms/d/e/1FAIpQLSeBAO0UFKDZyKpg2XzRslsLJVHU61ugjc18-2PVEabTQg2_6g/viewform?usp=sf_link" target="_blank">https://docs.google.com/forms/d/e/1FAIpQLSeBAO0UFKDZyKpg2XzRslsLJVHU61ugjc18-2PVEabTQg2_6g/viewform?usp=sf_link</a></div></div></blockquote><div><br></div><div>This looks like a very good start. A few thoughts:</div><div><br></div><div>In the description at the top of the survey, perhaps add a link to <a href="http://scipy.github.io/devdocs/">http://scipy.github.io/devdocs/</a>?</div><div><br></div><div>It would be good to get some info on the users answering the questions. E.g. beginner/imtermediate/advanced or years of experience. That way you can analyze the other answers better, for example if only 10% of respondents are beginners and they all say that tutorials need improving, that's 100% of beginners that need this.</div><div><br></div><div>I'm not a survey design expert, but I think it's more common to have 5 options for the "are you satisfied" or "is this clear" type of questions. With 3, you may get a lot of "neutral" responses.</div><div><br></div><div>To "which doc features need to be improved/added" you could add "Ease of navigation".<br></div><div><br></div><div>A question I would find interesting is "how do you view the docs (check all that apply)". Possible answers: online html docs, pdf, view docstring in terminal, Help feature in an IDE, Other.</div><div><br></div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><br></div><div>Also, I'm compiling a list of websites where I could deploy the survey to get a fair amount of responses. If you know any such websites, please let me know. </div></div></blockquote><div><br></div><div>When you say deploy I'm thinking SurveyMonkey or the like - you need just one of those, the Google Form you have may be perfectly fine. Response rates should be mostly determined by where we publicize the request for people to participate (or maybe that's what you meant). To mind come: mailing lists (SciPy and other projects, PyData, NumFOCUS), Twitter, post it on <a href="http://scipy.org">scipy.org</a>, the scipy IRC and numpy Gitter channels, and a blog post that shows up on Planet SciPy and Planet Python.</div><div><br></div><div>Cheers,<br></div><div>Ralf</div><div><br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><br></div><div>Your help is much appreciated!</div><div><br></div><div>All the best,</div><div>Maja Gwozdz</div></div>
_______________________________________________<br>
SciPy-Dev mailing list<br>
<a href="mailto:SciPy-Dev@python.org" target="_blank">SciPy-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/scipy-dev" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/scipy-dev</a><br>
</blockquote></div></div>