<div dir="auto"><div>I agree, though I'm curious if we still can't get one entry point which then fans out.  very basic, pyplot.plot() even.  more about plotting than python, matplotlib, math, geometry, etc.</div><div dir="auto"><br></div><div dir="auto">I bet I can hack the Sphinx script to pull all imported/used modules and functions except built -ins.  The examples/tutorials can be tagged with "requires/suggests knowing..." any non-matplotlib function.</div><div dir="auto"><br><div dir="auto"><div dir="auto">People then filter based on matplotlib tags of what they need to learn and select the examples that fit based on the python they are familiar with.  </div></div> </div><div dir="auto">theoretically I can mock this up.</div><div dir="auto"><br></div><div dir="auto">Before doing too much more, I would love to hear any dissenting opinions or even explicit support.  I have been involved in too many projects that ended in a bridge to nowhere.  I'll ask on gitter too.</div><div dir="auto"><br></div><div dir="auto">I definitely want to talk about surveying, I think no matter what that is required.<br><br><div class="gmail_quote" dir="auto"><div dir="ltr">On Tue, Feb 13, 2018, 08:12 Chris Barker - NOAA Federal <<a href="mailto:chris.barker@noaa.gov" target="_blank" rel="noreferrer">chris.barker@noaa.gov</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><br><blockquote type="cite"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>I agree that you can't get very far in Python without it, but it still majorly confuses the audiences I work with. Quite literally, the demarcation my fellowship makes between the Python 101 and 201 we teach is how explicitly we go into using objects. So I think an intro should provide at least a soft explanation of methods/objects/etc. <br></div></div></div></div></blockquote><div><br></div><div>THIS is maybe the core issue— are we introducing people to matplotlib, or to the python language via matplotlib. Indeed, to programming itself?</div><div><br></div><div>Each of these requires a different type of introduction.</div><div><br></div><div>Maybe multiple entry points:</div><div><br></div><div>- Know Basic Python?</div><div>- Know another programming language?</div><div>- New to programming?</div><div><br></div><div>Personally, I think it’s “better” to learn the basics of Python first, and then introduce the scipy stack, but the reality is that people have work to accomplish, and it’s often best to learn by solving a problem that interests you — so we should support that.</div><div><br></div><blockquote type="cite"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><span><blockquote type="cite"><div dir="ltr"><div class="gmail_quote"><div> they're all pyplot,</div></div></div></blockquote></span></div></blockquote></div></div></div></blockquote><div><br></div><div>The challenge with pyplot is the learning curve — it’s great to able to simply start with:</div><div><br></div><div>plot(x, y)</div><div><br></div><div><br></div><br><blockquote type="cite"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><span><blockquote type="cite"><div dir="ltr"><div class="gmail_quote"><div> but that seems to be the preferred intro-and I wonder if it'd be good for matplotlib to have more bridge documentation that doesn't just show how to do things both ways but explains why the OO way is better.</div></div></div></blockquote><div><br></div></span><div>Yup. And I don’t think pyplot is any easier for newbies—other than existing Matlab users — admittedly a big group.</div></div></blockquote><div><br></div><div>It is and it isn't. While it's technically still OO, I think it ends up feeling weirdly declarative just keep layering these things (kinda like ggplot), rather than the explicit here's an axis and attach information to it. It seems like a super trivial distinction but I think it may be a barrier for some people (also why I think a survey could be good here.)<br><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><br><div>I say introduce the OO interface, then have a “matplotlib for Matlab users” section to translate for them.</div></div></blockquote><div>I like this approach too.  <br></div></div><br></div></div>
</blockquote><blockquote type="cite"><div><span>_______________________________________________</span><br><span>Matplotlib-devel mailing list</span><br><span><a href="mailto:Matplotlib-devel@python.org" rel="noreferrer noreferrer" target="_blank">Matplotlib-devel@python.org</a></span><br><span><a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/matplotlib-devel</a></span><br></div></blockquote></div>
_______________________________________________<br>
Matplotlib-devel mailing list<br>
<a href="mailto:Matplotlib-devel@python.org" rel="noreferrer noreferrer" target="_blank">Matplotlib-devel@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer noreferrer noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/matplotlib-devel</a><br>
</blockquote></div></div></div>