From de3d9d4637552152db94d28e1623ad9f1570bb19 Mon Sep 17 00:00:00 2001
From: Marc Garcia
Date: Mon, 23 Sep 2019 19:25:12 +0100
Subject: [PATCH 1/4] More restructuring and styling
---
web/pandas/_templates/layout.html | 88 ++++++++++++-------
web/pandas/{community => about}/about.md | 0
web/pandas/{community => about}/citing.md | 4 +-
web/pandas/{community => about}/roadmap.md | 0
web/pandas/about/sponsors.md | 33 +++++++
web/pandas/{community => about}/team.md | 36 +-------
web/pandas/{ => community}/blog.html | 0
web/pandas/community/coc.md | 2 +-
web/pandas/community/ecosystem.md | 2 +-
web/pandas/config.yml | 53 +++++------
web/pandas/contribute.md | 12 +++
web/pandas/donate.md | 11 ---
web/pandas/{install.md => getting_started.md} | 27 +++++-
web/pandas/static/css/pandas.css | 40 ++++++++-
14 files changed, 196 insertions(+), 112 deletions(-)
rename web/pandas/{community => about}/about.md (100%)
rename web/pandas/{community => about}/citing.md (98%)
rename web/pandas/{community => about}/roadmap.md (100%)
create mode 100644 web/pandas/about/sponsors.md
rename web/pandas/{community => about}/team.md (63%)
rename web/pandas/{ => community}/blog.html (100%)
create mode 100644 web/pandas/contribute.md
rename web/pandas/{install.md => getting_started.md} (62%)
diff --git a/web/pandas/_templates/layout.html b/web/pandas/_templates/layout.html
index 253318182f30c..fe3e4d1245d93 100644
--- a/web/pandas/_templates/layout.html
+++ b/web/pandas/_templates/layout.html
@@ -20,41 +20,44 @@
{% endfor %}
+
-
-
-
+
+
+
+
- {% if static.logo %}
{% endif %}
+ {% if static.logo %}
{% endif %}
-
@@ -64,11 +67,30 @@
diff --git a/web/pandas/community/about.md b/web/pandas/about/about.md
similarity index 100%
rename from web/pandas/community/about.md
rename to web/pandas/about/about.md
diff --git a/web/pandas/community/citing.md b/web/pandas/about/citing.md
similarity index 98%
rename from web/pandas/community/citing.md
rename to web/pandas/about/citing.md
index 6bad948bb3736..77b79c41aa4d1 100644
--- a/web/pandas/community/citing.md
+++ b/web/pandas/about/citing.md
@@ -1,6 +1,6 @@
-# Citing pandas
+# Citing and logo
-## Citing
+## Citing pandas
If you use _pandas_ for a scientific publication, we would appreciate citations to one of the following papers:
diff --git a/web/pandas/community/roadmap.md b/web/pandas/about/roadmap.md
similarity index 100%
rename from web/pandas/community/roadmap.md
rename to web/pandas/about/roadmap.md
diff --git a/web/pandas/about/sponsors.md b/web/pandas/about/sponsors.md
new file mode 100644
index 0000000000000..352acf01e9efe
--- /dev/null
+++ b/web/pandas/about/sponsors.md
@@ -0,0 +1,33 @@
+# Sponsors
+
+## NumFOCUS
+
+
+
+_pandas_ is a Sponsored Project of [NumFOCUS](https://numfocus.org/), a 501(c)(3) nonprofit charity in the United States.
+NumFOCUS provides _pandas_ with fiscal, legal, and administrative support to help ensure the
+health and sustainability of the project. Visit numfocus.org for more information.
+
+Donations to _pandas_ are managed by NumFOCUS. For donors in the United States, your gift is tax-deductible
+to the extent provided by law. As with any donation, you should consult with your tax adviser about your particular tax situation.
+
+## Institutional partners
+
+
+ {% for company in partners.active if company.employs %}
+ {{ company.name }} ({{ company.employs }})
+ {% endfor %}
+
+
+## In-kind sponsors
+
+- [OVH](https://us.ovhcloud.com/): Hosting
+- [Indeed](https://opensource.indeedeng.io/): Logo and website design
+
+## Past institutional partners
+
+
diff --git a/web/pandas/community/team.md b/web/pandas/about/team.md
similarity index 63%
rename from web/pandas/community/team.md
rename to web/pandas/about/team.md
index c0a15081e1fa8..41da3a0e82bdb 100644
--- a/web/pandas/community/team.md
+++ b/web/pandas/about/team.md
@@ -36,25 +36,12 @@ If you want to support pandas development, you can find information in the [dona
{% endfor %}
-## BDFL
+## Governance
Wes McKinney is the Benevolent Dictator for Life (BDFL).
-## Governance
-
The project governance is available in the [project governance documents](https://github.com/pandas-dev/pandas-governance).
-## NumFOCUS
-
-
-
-_pandas_ is a Sponsored Project of [NumFOCUS](https://numfocus.org/), a 501(c)(3) nonprofit charity in the United States.
-NumFOCUS provides _pandas_ with fiscal, legal, and administrative support to help ensure the
-health and sustainability of the project. Visit numfocus.org for more information.
-
-Donations to _pandas_ are managed by NumFOCUS. For donors in the United States, your gift is tax-deductible
-to the extent provided by law. As with any donation, you should consult with your tax adviser about your particular tax situation.
-
## Code of conduct committee
@@ -71,19 +58,6 @@ to the extent provided by law. As with any donation, you should consult with you
{% endfor %}
-## Institutional partners
-
-
- {% for company in partners.active if company.employs %}
- {{ company.name }} ({{ company.employs }})
- {% endfor %}
-
-
-In-kind sponsors
-
-- [Indeed](https://opensource.indeedeng.io/): Logo and website design
-- Can we find a donor for the hosting (website, benchmarks,...?)
-
## Emeritus maintainers
@@ -91,11 +65,3 @@ In-kind sponsors
{{ person }}
{% endfor %}
-
-## Past institutional partners
-
-
diff --git a/web/pandas/blog.html b/web/pandas/community/blog.html
similarity index 100%
rename from web/pandas/blog.html
rename to web/pandas/community/blog.html
diff --git a/web/pandas/community/coc.md b/web/pandas/community/coc.md
index 2841349fdb556..de0e8120f7eee 100644
--- a/web/pandas/community/coc.md
+++ b/web/pandas/community/coc.md
@@ -1,4 +1,4 @@
-# Contributor Code of Conduct
+# Code of conduct
As contributors and maintainers of this project, and in the interest of
fostering an open and welcoming community, we pledge to respect all people who
diff --git a/web/pandas/community/ecosystem.md b/web/pandas/community/ecosystem.md
index af27c31b52d50..cf242e86f879f 100644
--- a/web/pandas/community/ecosystem.md
+++ b/web/pandas/community/ecosystem.md
@@ -1,4 +1,4 @@
-# Pandas ecosystem
+# Ecosystem
Increasingly, packages are being built on top of pandas to address
specific needs in data preparation, analysis and visualization. This is
diff --git a/web/pandas/config.yml b/web/pandas/config.yml
index c7c4b77e309f7..e98dfcd01b72d 100644
--- a/web/pandas/config.yml
+++ b/web/pandas/config.yml
@@ -4,12 +4,11 @@ main:
ignore:
- _templates/layout.html
- config.yml
- - blog.html # blog will be added at a later stage
- try.md # the binder page will be added later
github_repo_url: pandas-dev/pandas
context_preprocessors:
- pandas_web.Preprocessors.navbar_add_info
- # - pandas_web.Preprocessors.blog_add_posts
+ - pandas_web.Preprocessors.blog_add_posts
- pandas_web.Preprocessors.maintainers_add_info
- pandas_web.Preprocessors.home_add_releases
markdown_extensions:
@@ -17,46 +16,48 @@ main:
- tables
- fenced_code
static:
- logo: # path to the logo when it's in the repo
+ logo: # /static/img/pandas.svg
css:
- /static/css/pandas.css
navbar:
- - name: "Install"
- target: /install.html
+ - name: "About us"
+ target:
+ - name: "About pandas"
+ target: /about/about.html
+ - name: "Project roadmap"
+ target: /about/roadmap.html
+ - name: "Team"
+ target: /about/team.html
+ - name: "Sponsors"
+ target: /about/sponsors.html
+ - name: "Citing and logo"
+ target: /about/citing.html
+ - name: "Getting started"
+ target: /getting_started.html
- name: "Documentation"
target:
- - name: "Getting started"
- target: /docs/getting_started/index.html
- name: "User guide"
target: /docs/user_guide/index.html
- name: "API reference"
target: /docs/reference/index.html
- - name: "Contributing to pandas"
- target: /docs/development/index.html
- name: "Release notes"
target: /docs/whatsnew/index.html
+ - name: "Older versions"
+ target: https://pandas.pydata.org/pandas-docs/version/
- name: "Community"
target:
- - name: "About pandas"
- target: /community/about.html
- - name: "Project roadmap"
- target: /community/roadmap.html
- - name: "Ecosystem"
- target: /community/ecosystem.html
+ - name: "Blog"
+ target: /community/blog.html
- name: "Ask a question (StackOverflow)"
target: https://stackoverflow.com/questions/tagged/pandas
- - name: "Discuss (mailing list)"
- target: https://groups.google.com/forum/#!forum/pydata
- - name: "Team"
- target: /community/team.html
- - name: "Code of Conduct"
+ - name: "Discuss"
+ target: https://pandas.discourse.group
+ - name: "Code of conduct"
target: /community/coc.html
- - name: "Citing pandas"
- target: /community/citing.html
- # - name: "Blog"
- # target: /blog.html
- - name: "Donate"
- target: /donate.html
+ - name: "Ecosystem"
+ target: /community/ecosystem.html
+ - name: "Contribute"
+ target: /contribute.html
blog:
num_posts: 8
feed:
diff --git a/web/pandas/contribute.md b/web/pandas/contribute.md
new file mode 100644
index 0000000000000..6d8fb9e224fe1
--- /dev/null
+++ b/web/pandas/contribute.md
@@ -0,0 +1,12 @@
+# Contribute to pandas
+
+_pandas_ is and always will be **free**. To make de development sustainable, we need _pandas_ users, corporate
+or individual, to support the development by providing their time and money.
+
+You can find more information about current developers in the [team page](about/team.html),
+and about current sponsors in the [sponsors page](about/sponsors.html).
+Financial contributions will mainly be used to advance in the [pandas roadmap](about/roadmap.html).
+
+- If your **company or organization** is interested in helping make pandas better, please contact us at [info@numfocus.org](mailto:info@numfocus.org)
+- If you want to contribute to _pandas_ with your **time**, please visit the [contributing page]({{ base_url }}/docs/development/index.html)
+- If you want to support _pandas_ with a **donation**, please use the [donations page](donate.html).
diff --git a/web/pandas/donate.md b/web/pandas/donate.md
index 5f5b07fb8763c..69db7e4648e77 100644
--- a/web/pandas/donate.md
+++ b/web/pandas/donate.md
@@ -1,16 +1,5 @@
# Donate to pandas
-_pandas_ is and always will be **free**. To make de development sustainable, we need _pandas_ users, corporate
-or individual, to support the development by providing their time and money.
-
-You can find more information about current developers and supporters in the [team page](community/team.html).
-Financial contributions will mainly be used to advance in the [pandas roadmap](community/roadmap.html).
-
-- If your **company or organization** is interested in helping make pandas better, please contact us at [info@numfocus.org](mailto:info@numfocus.org)
-- If you want to contribute to _pandas_ with your **time**, please visit the [contributing page]({{ base_url }}/docs/development/index.html)
-- If you want to support _pandas_ with a **donation**, please use the form below:
-
-
-5. Now you are ready to use pandas you can write your code in the next cells.
+5. Now you are ready to use pandas, and you can write your code in the next cells.
+## Tutorials
You can learn more about pandas in the [tutorials](#), and more about JupyterLab
in the [JupyterLab documentation](https://jupyterlab.readthedocs.io/en/stable/user/interface.html).
+
+## Books
+
+The book we recommend to learn pandas is [Python for Data Analysis](https://amzn.to/2KI5JJw),
+by [Wes McKinney](https://wesmckinney.com/), creator of pandas.
+
+
+
+
+
+## Videos
+
+
+
+## Cheat sheet
+
+[pandas cheat sheet](https://pandas.pydata.org/Pandas_Cheat_Sheet.pdf)
diff --git a/web/pandas/static/css/pandas.css b/web/pandas/static/css/pandas.css
index 5911de96b5fa9..0a227cf8d96c9 100644
--- a/web/pandas/static/css/pandas.css
+++ b/web/pandas/static/css/pandas.css
@@ -1,16 +1,54 @@
body {
padding-top: 5em;
- padding-bottom: 3em;
+ color: #444;
+}
+h1 {
+ font-size: 2.4rem;
+ font-weight: 700;
+ color: #130654;
+}
+h2 {
+ font-size: 1.45rem;
+ font-weight: 700;
+ color: black;
+}
+h3 {
+ font-size: 1.3rem;
+ font-weight: 600;
+ color: black;
+}
+a {
+ color: #130654;
}
code {
white-space: pre;
}
+.fab {
+ font-size: 1.2rem;
+ color: #666;
+}
+.fab:hover {
+ color: #130654;
+}
a.navbar-brand img {
max-height: 2em;
}
div.card {
margin: 0 0 .2em .2em !important;
}
+div.card .card-title {
+ font-weight: 500;
+ color: #130654;
+}
.book {
padding: 0 20%;
}
+.bg-dark {
+ background-color: #130654 !important;
+}
+.navbar-dark .navbar-nav .nav-link {
+ color: rgba(255, 255, 255, .9);
+}
+.navbar-dark .navbar-nav .nav-link:hover {
+ color: white;
+}
From 358d5bcdf4d1695d7f78ec88d51e3b3c38fe70fc Mon Sep 17 00:00:00 2001
From: Marc Garcia
Date: Mon, 23 Sep 2019 22:52:11 +0100
Subject: [PATCH 2/4] Updating links to install
---
web/pandas/index.html | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/web/pandas/index.html b/web/pandas/index.html
index 9f1a0e9a64174..df6e5ab9a330b 100644
--- a/web/pandas/index.html
+++ b/web/pandas/index.html
@@ -10,7 +10,7 @@ pandas
built on top of the Python programming language.
- Install pandas now!
+ Install pandas now!
@@ -19,7 +19,7 @@ pandas
Getting started
From 66bec72dc8941b2f5ae4294285228bfb1ad66a90 Mon Sep 17 00:00:00 2001
From: Marc Garcia
Date: Thu, 26 Sep 2019 00:22:32 -0300
Subject: [PATCH 3/4] Fix typo in contribute.md
Co-Authored-By: Joris Van den Bossche
---
web/pandas/contribute.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/web/pandas/contribute.md b/web/pandas/contribute.md
index 6d8fb9e224fe1..825a5870bf5a0 100644
--- a/web/pandas/contribute.md
+++ b/web/pandas/contribute.md
@@ -1,6 +1,6 @@
# Contribute to pandas
-_pandas_ is and always will be **free**. To make de development sustainable, we need _pandas_ users, corporate
+_pandas_ is and always will be **free**. To make the development sustainable, we need _pandas_ users, corporate
or individual, to support the development by providing their time and money.
You can find more information about current developers in the [team page](about/team.html),
From cbc3a41b9fdef5f977a004edb503015555406fd3 Mon Sep 17 00:00:00 2001
From: Marc Garcia
Date: Thu, 26 Sep 2019 00:33:55 -0300
Subject: [PATCH 4/4] PR comments, adding Tidelift and renaming about/about to
about/index
---
web/pandas/about/{about.md => index.html} | 0
web/pandas/about/sponsors.md | 8 ++++++++
web/pandas/config.yml | 2 +-
3 files changed, 9 insertions(+), 1 deletion(-)
rename web/pandas/about/{about.md => index.html} (100%)
diff --git a/web/pandas/about/about.md b/web/pandas/about/index.html
similarity index 100%
rename from web/pandas/about/about.md
rename to web/pandas/about/index.html
diff --git a/web/pandas/about/sponsors.md b/web/pandas/about/sponsors.md
index 352acf01e9efe..dcc6e367e5d64 100644
--- a/web/pandas/about/sponsors.md
+++ b/web/pandas/about/sponsors.md
@@ -11,8 +11,16 @@ health and sustainability of the project. Visit numfocus.org for more informatio
Donations to _pandas_ are managed by NumFOCUS. For donors in the United States, your gift is tax-deductible
to the extent provided by law. As with any donation, you should consult with your tax adviser about your particular tax situation.
+## Tidelift
+
+_pandas_ is part of the [Tidelift subscription](https://tidelift.com/subscription/pkg/pypi-pandas?utm_source=pypi-pandas&utm_medium=referral&utm_campaign=readme).
+You can support pandas by becoming a Tidelift subscriber.
+
## Institutional partners
+Institutional Partners are companies and universities that support the project by employing contributors.
+Current Institutional Partners include:
+
{% for company in partners.active if company.employs %}
{{ company.name }} ({{ company.employs }})
diff --git a/web/pandas/config.yml b/web/pandas/config.yml
index e98dfcd01b72d..d5c505f298437 100644
--- a/web/pandas/config.yml
+++ b/web/pandas/config.yml
@@ -23,7 +23,7 @@ navbar:
- name: "About us"
target:
- name: "About pandas"
- target: /about/about.html
+ target: /about/index.html
- name: "Project roadmap"
target: /about/roadmap.html
- name: "Team"