Update homepage to be more readable and user-friendly #878
Conversation
There was a problem hiding this comment.
Thanks @paigem and @abarciauskas-bgse for this first draft! I think it looks great, I really like the really simple landing page explaining where to go next.
I made a few comments directly on the changes, and here are another one:
Remove the feeds to Twitter and Discourse (side note: the Discourse one seems to currently show July posts?) so as to not clutter the homepage
Discourse might not be really useful, and not up to date on my screen either. However, it would be really nice if the home page had some "News feed", to show Pangeo last events/news. If the Twitter feed is the closest to this, I'd vote to leave it on first page.
| @@ -115,7 +119,7 @@ | |||
| # an arbitrary url. | |||
| 'navbar_links': [ | |||
| ("Blog", "https://medium.com/pangeo", True), | |||
| ("Forum", "https://discourse.pangeo.io", True), | |||
| ("Discourse Forum", "https://discourse.pangeo.io", True), | |||
There was a problem hiding this comment.
I'm not sure that adding 'Discourse' is really needed in the navbar.
There was a problem hiding this comment.
I agree that a longer name might be less useful, but Aimee and I both mentioned that we were confused about this terminology during our first few Pangeo website visits years ago. In my experience, most Pangeo folks refer to it as "Discourse" and in initially I didn't know that "Discourse" was a web forum.
Maybe we can get some others to weight in here, but I'd still vote for "Discourse Forum" in the navbar for extra clarity.
| :align: left | ||
|
|
||
| * - ❓ Have questions about Python software? | ||
| - 🤩 Want to hear about new updates to Pangeo software or infrastructure? |
There was a problem hiding this comment.
Pangeo software: what is it? Pangeo ecosystem?
There was a problem hiding this comment.
Good point! Maybe Pangeo software is poorly defined. (Though we could like to the Pangeo Packages page, which also needs a serious update!)
I like your suggestion of "Pangeo ecosystem", as it encompasses more than just the software side of Pangeo. My only hesitation there is that the term is more vague. The table I added here is largely to steer people in the right direction quickly. It's hard to know, but I'd guess that a lot of visitors to the site are there to find quick answers to coding problems, in which case explicitly stating "software" instead of "ecosystem" might be more functional. My primary goal with this table is to address some of the most frequent questions our site visitors may have.
That all being said, happy to change to "ecosystem" if we think that's best! 😊
| - 🧐 Just curious to learn more about Pangeo? | ||
| * - Search for answers or ask your own question on the `Pangeo Discourse Forum <https://discourse.pangeo.io/>`_! | ||
| - Check out our `Medium blog <https://medium.com/pangeo>`_ and our `Twitter feed <https://twitter.com/pangeo_data>`_! | ||
| - Post or answer questions in the `Pangeo Discourse Forum <https://discourse.pangeo.io/>`_, attend a `community meeting <https://pangeo.io/meeting-notes.html>`_, or start issues/create pull requests on our `GitHub repos <https://github.com/pangeo-data/>`_! |
There was a problem hiding this comment.
| - Post or answer questions in the `Pangeo Discourse Forum <https://discourse.pangeo.io/>`_, attend a `community meeting <https://pangeo.io/meeting-notes.html>`_, or start issues/create pull requests on our `GitHub repos <https://github.com/pangeo-data/>`_! | |
| - Post or answer questions in the `Pangeo Discourse Forum <https://discourse.pangeo.io/>`_, attend a `community meeting <https://pangeo.io/meeting-notes.html>`_, or open issues/create pull requests on our `GitHub repos <https://github.com/pangeo-data/>`_! |
| ^^^^^^^^^^^^^^ | ||
|
|
||
| Science applications and detailed tutorial for using Pangeo can be found in | ||
| `Pangeo Gallery <http://gallery.pangeo.io>`_. |
There was a problem hiding this comment.
I think this is important to have a Pangeo Gallery link somewhere in the homepage. Maybe in 'learn more' table section?
| - Read about us on the `About Pangeo page <https://pangeo.io/about.html>`_. | ||
|
|
||
| .. | ||
| This portion is currently commented out rather than deleted, because it appears that the "toctree" here may be |
There was a problem hiding this comment.
Yep, this is what sphinx uses to figure out which documents in the build (https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html?highlight=toctree#table-of-contents).
Did you comment it out since you didn't want to include the toctree on the homepage? If you want, you can do something like
.. toctree::
:hidden:
about
...
to hide the toctree. I think we'd still want some way to navigate to those pages though, and I'm not sure how hidden interacts with the sphinx's navigation stuff.
This is currently a draft PR meant mostly to share the code that I've created so far. I expect many conversations either in relevant issues (e.g. #873) and on the Discourse Forum post here about how to further improve the homepage, but this is a start!
I worked with @abarciauskas-bgse on this PR.
What we discussed today/rationales for our suggested update:
The screenshot below is our first draft of an updated website. Note that I am new to rst and so the presentation of the content could likely be easily improved by those who are more familiar with rst!