<div dir="auto">Hi Matt,<div dir="auto">I'm super psyched that you're onboard and totally agree with you on the importance of identifying audience. I think that's a lot of where the docs really struggle because the audience is very broad. </div><div dir="auto"><br></div><div dir="auto">For example, I introduce matplotlib a lot to the following audiences who I don't think you've mentioned yet:</div><div dir="auto"><br></div><div dir="auto">high school students</div><div dir="auto">-little to no programming classes </div><div dir="auto">-a summer REU </div><div dir="auto">-only know about the plots they've seen in their science class</div><div dir="auto"><br></div><div dir="auto">humanaties masters and graduate students </div><div dir="auto">- little/no programming experience</div><div dir="auto">- frame of reference for visualization is usually journalism viz like New York Times or art installations. </div><div dir="auto">- often don't have or forgot the vocabulary around  scientific and statistical plots (what is a measurment, scale, etc)</div><div dir="auto"><br></div><div dir="auto">Computer Science students </div><div dir="auto">- undergrad through grad</div><div dir="auto">- taking a visualization course</div><div dir="auto">- have lots of programming experience, but not necessarily in Python</div><div dir="auto">- want to make highly information dense plots or dashboards</div><div dir="auto"><br></div><div dir="auto"><br></div>And I really would love a survey of the community to get an even better sense of who is using matplotlib.<div dir="auto"><br></div><div dir="auto">-Hannah<br><div class="gmail_extra" dir="auto"><br><div class="gmail_quote">On Feb 8, 2018 3:30 AM, "Matt Arcidy" <<a href="mailto:marcidy@gmail.com" target="_blank">marcidy@gmail.com</a>> wrote:<br type="attribution"><blockquote class="m_-4344593674584930155quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hi All,<div><br><div>Please forgive the presumption of pulling this topic out of from the meeting thread especially as this is also in a self-introduction email.</div><div><br></div><div>I want to help with the documentation effort.  I read Tom's article in numfocus and the desired skillset rang true.  I have 10ish years experience writing tech docs, a few 100+ pages.   I write creatively, and I am still somewhat new to matplotlib.  I am happy to work in any capacity, though i am most interested in cranking out the first draft of the book.  </div><div><br></div><div>I have looked into the available documentation over the past month+ so I could come with understanding and ideas, some of which I hope are actually good.</div><div><br></div><div>Both the meeting thread and Tom requested ideas for reorganizing the tutorials and examples as a place to start, so I'll throw one out: explicit definition of an audience, something to which all the documentation can adhere.</div><div><br></div><div>Right now the tutorials are leveled as beginner, intermediate, and expert, which is great, but it's not clear what that means.  Explicitly defining the required skill sets, while not perfect, will allow sorting of concepts and people into each bin.  </div><div><br></div><div>As an example, (please excuse the contrivence):</div><div><br></div><div>Laura </div><div>- Sophomore in college</div><div>- dead set on being a data scientist</div><div>- 2 programming classes in python</div><div>- never used any kind of CAD software ever (i.e. does not have any concept of a plot beyond a line on graph paper)</div><div><br></div><div>Xian </div><div>- 1 week away from Zoology PhD dissertation, under a deadline</div><div>- Has used R and Matplotlib to create very basic plots for papers</div><div>- Wants to create a plot with species heart size over adult weight, with the marker being a jpg of the species' actual heart, beating at the actual species' heart rate on the plot.</div><div><br></div><div>Ayah </div><div>- Post Doc or professional</div><div>- 10+ years of plotting experience using various packages but not matplotlib</div><div>- has funding to contribute significant functionality, but needs to get up to speed on everything now</div><div><br></div><div>Obviously this is just beginner, intermediate, expert, but they can be explicitly targeted/taught based on their skill level.  Laura needs hand-holding, Xian needs a great API reference, Ayah needs a mosaic of everything and a good architecture map.</div><div><br></div><div>In the same vein as above, learning paths through the tutorial documents.  There are some separable plotting skills, like visually designing the plot, animation, application development, matplotlib development...etc. Each skill could have beginner/intermediate/expert level tutorials which progress naturally, creating a learning tract for each skill.  Skills can be stacked to flow into specific roles.</div><div><br></div><div>Looking at this from outside, the best part about this project is all the information is already there. I have more ideas to dump on you, but I'll postpone until I have a better understanding of where I can fit.</div><div><br></div><div>Thanks!</div></div></div>
<br>______________________________<wbr>_________________<br>
Matplotlib-devel mailing list<br>
<a href="mailto:Matplotlib-devel@python.org" target="_blank">Matplotlib-devel@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/matplotlib-devel</a><br>
<br></blockquote></div><br><br></div></div></div>