<div dir="ltr">I missed the discussion about the docs, so<div>1. s-g is great for standalone examples but I would also prefer plain rst for long tutorials (with e.g. vim-restructuredtext I can have both syntax highlighting of rst parts in rst and python code-blocks in python (and likewise for other languages) if the file is rst; for a .py file there is no special recognition of rst markup by the editor).</div><div>2. any specific points about "python authoring less than desirable" for rst?  what functionalities would be desirable?</div><div>  possible relevant links (some already mentioned above): <a href="https://nbsphinx.readthedocs.io/en/0.3.1/">https://nbsphinx.readthedocs.io/en/0.3.1/</a> <a href="https://github.com/ngoldbaum/RunNotebook">https://github.com/ngoldbaum/RunNotebook</a> <a href="https://github.com/matthew-brett/nb2plots">https://github.com/matthew-brett/nb2plots</a></div><div><br></div><div>Antony</div></div><div class="gmail_extra"><br><div class="gmail_quote">2018-01-31 13:10 GMT-08:00 Jody Klymak <span dir="ltr"><<a href="mailto:jklymak@uvic.ca" target="_blank">jklymak@uvic.ca</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">More call notes, this time from a more definitive source @tacaswell!<br>
<br>
- discussion about how to manage<br>
- discussion about docs<br>
  - TAC: we have money to organize a mini-conference (from active state)<br>
  - EF: are we settled enough to do this? Do we want to leave it more dynamic?<br>
  Â  - discoverability is mostly just google<br>
  Â  Â  - our API is overly complicated and organically grown<br>
  Â  Â  - major barrier to discoverability / usability<br>
  Â  - maybe we want to clean up the API (aggressively?) first<br>
  Â  - leads to questions about to define the agenda of mini-workshop<br>
  - JK: need an intermediate between what we have and a 200 page book<br>
  Â  - need to order the sphinx-gallery entries<br>
  - EF: consider reverting the tutorials as sphinx-gallery<br>
  Â  - need more control of ordering, but works well for examples<br>
  Â  - wrong tool for tutorials<br>
  Â  - look into sphinx-notebook<br>
  Â  - move back to plain sphinx?<br>
  - TAC: we need to develop agenda for mini-workshop that addresses the above<br>
  - EF: before workshop is there a way to gather user requirements?<br>
  Â  - TAC: user interviews, plausible, may also be part of work, can start now.<br>
  Â  - JK: we can start collecting comments ahead of time<br>
  Â  Â  - JK will work on managing this!<br>
<div class="HOEnZb"><div class="h5"><br>
> On 31 Jan 2018, at 10:41, Jody Klymak <<a href="mailto:jklymak@uvic.ca">jklymak@uvic.ca</a>> wrote:<br>
><br>
> Hi all,<br>
><br>
> Call notes from Monday’s call.<br>
><br>
> Cheers,  Â Jody<br>
><br>
><br>
> On call: Thomas, Eric, Ryan, Jody, Antony (later half)<br>
><br>
> ## Documentation<br>
><br>
> Thomas reported that there is a fund for a mini-workshop to scope out documentation changes.  Plan was to use that to write a proposal to fund a book.<br>
>  - Eric expressed some reservations about a book, given the state of flux some parts of Matplotlib are in.<br>
>  - Jody noted that beyond the book, a shorter â€œgetting started” guide on the webpage would still be desirable:<br>
><br>
>  Â  Â  Â ACTION: Jody to co-ordinate a couple of outline documents that could start outlining both of these projects before any meeting.<br>
><br>
> There was also some discussion of online documentation technology:<br>
>  - Notebooks (via nbsphinx: <a href="https://nbsphinx.readthedocs.io" rel="noreferrer" target="_blank">https://nbsphinx.readthedocs.<wbr>io</a>)<br>
>  Â  Â  Â - hard to make PRs with.  Diffs are a mess in GitHub.<br>
>  Â  Â  - Can’t use emacs (easily)<br>
>  - RST-based, with plot directive:<br>
>  Â  Â  Â - python authoring less than desirable<br>
>  - Sphinx-gallery based:<br>
>  Â  Â  Â - rst authoring less than desirable<br>
>  Â  Â  Â - sphinx gallery has very restricted ordering methods (file size and alphabetical)<br>
><br>
> ## Release 2.2<br>
><br>
> Various Release-Critical PRs were looked at.<br>
><br>
><br>
> --<br>
> Jody Klymak<br>
> <a href="http://web.uvic.ca/~jklymak/" rel="noreferrer" target="_blank">http://web.uvic.ca/~jklymak/</a><br>
><br>
><br>
><br>
><br>
><br>
> ______________________________<wbr>_________________<br>
> Matplotlib-devel mailing list<br>
> <a href="mailto:Matplotlib-devel@python.org">Matplotlib-devel@python.org</a><br>
> <a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/matplotlib-<wbr>devel</a><br>
<br>
--<br>
Jody Klymak<br>
<a href="http://web.uvic.ca/~jklymak/" rel="noreferrer" target="_blank">http://web.uvic.ca/~jklymak/</a><br>
<br>
<br>
<br>
<br>
<br>
______________________________<wbr>_________________<br>
Matplotlib-devel mailing list<br>
<a href="mailto:Matplotlib-devel@python.org">Matplotlib-devel@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/matplotlib-<wbr>devel</a><br>
</div></div></blockquote></div><br></div>