From e9c56436ea565ce074a98812bd09129846e7528f Mon Sep 17 00:00:00 2001 From: Ben Nathanson Date: Fri, 22 May 2020 12:14:21 -0400 Subject: [PATCH 1/2] DOC: Integrate Learn and Documentation pages Adds a link to the NumPy docs and clearly explains the remainder of the page as external. Adds a link to the contribution info at bottom and gives it a heading. --- content/en/learn.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/en/learn.md b/content/en/learn.md index e0d93cf1d6..cb9556c12d 100644 --- a/content/en/learn.md +++ b/content/en/learn.md @@ -1,16 +1,16 @@ --- -title: Learn +title: Documentation sidebar: false --- -To learn how to use NumPy, you could begin with the resources listed under the **'Beginners'** section. Once you gain a broad view, you could try the more involved tutorials and resources listed under the **'Advanced'** section. +

The official NumPy documentation lives at https://numpy.org/doc.

-This is a curated collection of NumPy related educational resources. Some are very specific to NumPy, while others offer a broader view on numerical computing. It is a continuously evolving list. In case you would like to contribute, please refer to the information at the bottom of this page. +Below is a curated collection of external resources. To contribute, see [below](#add-to-this-list). *** ## Beginners -There is tons of information about NumPy out there. If you are new to NumPy, we'd strongly recommend the following tutorials, books and videos to get started. +There's a ton of information about NumPy out there. If you are new, we'd strongly recommend these: **Tutorials** @@ -30,7 +30,7 @@ There is tons of information about NumPy out there. If you are new to NumPy, we' * [From Python to NumPy *by Nicolas P. Rougier*](https://www.labri.fr/perso/nrougier/from-python-to-numpy/) * [Elegant SciPy](https://www.amazon.com/Elegant-SciPy-Art-Scientific-Python/dp/1491922877) *by Juan Nunez-Iglesias, Stefan van der Walt and Harriet Dashnow* -Besides the ones listed above, you may want to check out the [Goodreads list](https://www.goodreads.com/shelf/show/python-scipy) on the subject of "Python+SciPy". Most of the books on this list are about the "SciPy ecosystem", which has NumPy at its core. +You may also want to check out the [Goodreads list](https://www.goodreads.com/shelf/show/python-scipy) on the subject of "Python+SciPy". Most books there are about the "SciPy ecosystem," which has NumPy at its core. **Videos** @@ -40,7 +40,7 @@ Besides the ones listed above, you may want to check out the [Goodreads list](ht ## Advanced -If you have the basic know-how of NumPy and how to use it, you can try these advanced tutorials, books and videos for a better understanding of the specific NumPy concepts such as advanced indexing, splitting, stacking, linear algebra and more. +Try these advanced resources for a better understanding of NumPy concepts like advanced indexing, splitting, stacking, linear algebra, and more. **Tutorials** @@ -78,6 +78,6 @@ If you have the basic know-how of NumPy and how to use it, you can try these adv If NumPy has been significant in your research, and you would like to acknowledge the project in your academic publication, please see [this citation information](/citing-numpy). -*** - -_If you would like to contribute to this collection of NumPy Learning resources, please submit your recommendation [here via a pull request](https://github.com/numpy/numpy.org/blob/master/content/en/learn.md). Make sure that your submission includes a brief description regarding why it deserves mention on numpy.org and what audience would benefit from it the most._ +## Contribute to this list + +To add to this collection, submit a recommendation [via a pull request](https://github.com/numpy/numpy.org/blob/master/content/en/learn.md). Say why your recommendation deserves mention on this page and also which audience would benefit most. From da8749b0665d68ddc3d09e56f6adbe2652b1f233 Mon Sep 17 00:00:00 2001 From: Ralf Gommers Date: Sun, 24 May 2020 09:13:06 +0200 Subject: [PATCH 2/2] Minor tweaks to the Learn page edits --- content/en/learn.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/learn.md b/content/en/learn.md index cb9556c12d..a8f9ef2021 100644 --- a/content/en/learn.md +++ b/content/en/learn.md @@ -1,11 +1,11 @@ --- -title: Documentation +title: Learn sidebar: false --- -

The official NumPy documentation lives at https://numpy.org/doc.

+The official NumPy documentation lives at https://numpy.org/doc. -Below is a curated collection of external resources. To contribute, see [below](#add-to-this-list). +Below is a curated collection of external resources. To contribute, see the [end of this page](#add-to-this-list). *** ## Beginners @@ -30,7 +30,7 @@ There's a ton of information about NumPy out there. If you are new, we'd strongl * [From Python to NumPy *by Nicolas P. Rougier*](https://www.labri.fr/perso/nrougier/from-python-to-numpy/) * [Elegant SciPy](https://www.amazon.com/Elegant-SciPy-Art-Scientific-Python/dp/1491922877) *by Juan Nunez-Iglesias, Stefan van der Walt and Harriet Dashnow* -You may also want to check out the [Goodreads list](https://www.goodreads.com/shelf/show/python-scipy) on the subject of "Python+SciPy". Most books there are about the "SciPy ecosystem," which has NumPy at its core. +You may also want to check out the [Goodreads list](https://www.goodreads.com/shelf/show/python-scipy) on the subject of "Python+SciPy". Most books there are about the "SciPy ecosystem", which has NumPy at its core. **Videos**