<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jul 16, 2019 at 9:57 AM Sebastian Berg <<a href="mailto:sebastian@sipsolutions.net">sebastian@sipsolutions.net</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">On Tue, 2019-07-16 at 07:06 -0600, Charles R Harris wrote:<br>
> Hi Dashamir,<br>
> <br>
> On Mon, Jul 15, 2019 at 4:49 PM Dashamir Hoxha <<a href="mailto:dashohoxha@gmail.com" target="_blank">dashohoxha@gmail.com</a>><br>
> wrote:<br>
> > Hi,<br>
> > <br>
> > With respect to this call for contributions: <br>
> > <a href="https://github.com/numpy/numpy/pull/13988/files" rel="noreferrer" target="_blank">https://github.com/numpy/numpy/pull/13988/files</a><br>
> > I would like to help with improving the website of numpy (and maybe<br>
> > scipy as well).<br></blockquote><div><br></div><div>Thanks for offering to help Dashamir!</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">
> > I have also applied for the Google Season of Docs 2019, and if<br>
> > accepted, I will be starting by the beginning of August.<br>
> > <br>
> > The improvements that I would like to make include:<br>
> > - Making the website responsive (so that it looks nice on small<br>
> > screens as well). There are responsive themes for sphinx and I may<br>
> > use one of them.<br>
> > - Improving the main page (or the landing page) so that it looks a<br>
> > bit more modern and attractive.<br>
> > - Reorganizing the structure of the information on the website, so<br>
> > that people from different backgrounds (students, professionals,<br>
> > etc.) can find more easily the relevant information that they are<br>
> > looking for. Including references to the external tutorials or<br>
> > courses about NumPy/SciPy.<br></blockquote><div><br></div><div>This all sounds good. I just sent another email about the <a href="http://numpy.org">numpy.org</a> redesign, please feel free to jump in on the proposal (<a href="https://github.com/numpy/numpy/pull/14032">https://github.com/numpy/numpy/pull/14032</a>).</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> > <br>
> > Other tentative improvements may be these:<br>
> > - Reorganize the docs so that each major release has its own<br>
> > version of docs. Major releases are those that may introduce new<br>
> > features, or in general, changes in the API (minor releases are the<br>
> > maintenance releases, which fix bugs, or make small changes, for<br>
> > example to improve the efficiency, but do not change the API). For<br>
> > example major releases may be v1.15, v1.16, v1.17 (however I am not<br>
> > sure about this).<br></blockquote><div><br></div><div>Note that the docs are kept separate from the <a href="http://numpy.org">numpy.org</a> site, and when we move <a href="http://numpy.org">numpy.org</a> away from Sphinx that separation will be clearer. <br></div><div>Matti is already working on this multi-version reshuffle in <a href="https://github.com/numpy/numpy/pull/13886">https://github.com/numpy/numpy/pull/13886</a>. <br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> > - Reorganize the docs so that the core API functionality is shown<br>
> > more prominently than the rest, and so that functions that may be<br>
> > deprecated in the future can be marked so (in order to discourage<br>
> > users from using them) and alternative solutions are suggested<br>
> > instead of them, etc.<br></blockquote><div><br></div><div>This is a good idea. That sounds more like a GSoD topic - it's quite some work to do, and to agree on the choices of what's important.</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">
> > - Allow the users to add comments for each function or package.<br>
> > These may be usage examples for the benefit of other users, or<br>
> > pitfall alerts, or even bug reports. Reporting bugs on GitHub is<br>
> > better of course, but this may be a bit easier for the users.<br></blockquote><div><br></div><div>This one I'm not so sure about. Could result in a lot more work for us......</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">
> > <br>
> > Since these are not incremental changes, if may be better if I work<br>
> > on a fork of the website repository, until they are finished and<br>
> > the new website is ready.<br></blockquote><div><br></div><div>Yes, would be good to start in a clean repo. I'd like to get the NEP accepted first, and then put together a bit of a plan so multiple people can work together on this.</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">
> > <br>
> > <br>
> <br>
> That sounds interesting and ambitious. I'll let others offer<br>
> suggestions, we might want to host the site at a different provider<br>
> which will offer easier access to developers. The repo is at at  <br>
> <a href="https://github.com/numpy/numpy.org" rel="noreferrer" target="_blank">https://github.com/numpy/numpy.org</a>. There is also a <a href="http://scipy.org" rel="noreferrer" target="_blank">scipy.org</a> website<br>
> that could also use some work.<br>
> <br>
<br>
<br>
Indeed, great to see interest, it sounds very nice! I believe you are<br>
already in contact with Ralf directly (just in case someone wonders if<br>
there might be little immediate followup on the mailing list).<br>
<br>
Best,<br>
<br>
Sebastian<br>
<br>
<br>
> Chuck<br>
> _______________________________________________<br>
> NumPy-Discussion mailing list<br>
> <a href="mailto:NumPy-Discussion@python.org" target="_blank">NumPy-Discussion@python.org</a><br>
> <a href="https://mail.python.org/mailman/listinfo/numpy-discussion" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/numpy-discussion</a><br>
_______________________________________________<br>
NumPy-Discussion mailing list<br>
<a href="mailto:NumPy-Discussion@python.org" target="_blank">NumPy-Discussion@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/numpy-discussion" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/numpy-discussion</a><br>
</blockquote></div></div>