# How should we update the Pangeo website to better serve the community?

**URL:** https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295
**Category:** News & Announcements
**Created:** [March 9, 2022, 3:49am UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295 "2022-03-09T03:49:10Z")
**Posts on this page:** 18
**Page:** 1

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [March 9, 2022, 3:49am UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/1 "2022-03-09T03:49:10Z")

</div>

@annefou and I are developing ideas about how to update the Pangeo website.

Our goals are:

- Deliver the message Pangeo is an open source community to support tools for open science.
- Make it clear Pangeo is _not_ one stack of cloud infrastructure.
- Make Pangeo website more accessible to newcomers and guide them in their first steps with the  
Pangeo community.

Questions for this post:

- Are those the right goals for the website ☝ ?
- What is a need of the existing and potential pangeo community that the website can fill?
- Is it to help people get involved? Is it to understand how to deploy or use open science software? Is it to see examples of pangeo in action?
- Are any of those needs being met partially in other mediums?

Next steps:

- Create some messaging about rebranding Pangeo as an open source open science community.
- Get feedback on this post from Pangeo stakeholders and the wider community (post to twitter?)
- Inventory the website and decide if there is material that should be removed completely or is out of date and confusing.

---

<div class="post-metadata">

### Author: ![rabernat](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/rabernat/32/22_2.png) [@rabernat](https://discourse.pangeo.io/u/rabernat)
#### Post date: [March 9, 2022, 1:45pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/2 "2022-03-09T13:45:15Z")

</div>

Thanks for taking the lead here Amy! 🚀

> [@aimeeb](#):
>
> Are those the right goals for the website ☝ ?

Those goals sounds good to me. I would emphasize that a goal of the website should be to route users to more specific resources (e.g. this discourse) or perhaps also a “Pangeo Book” that can serve as a more detailed technical guide, separate from the main site.

Also, while I agree Pangeo is not one stack of cloud infrastructure, we are in fact still running our Pangeo Cloud hubs, and people are using them. So we can’t neglect that completely.

> [@aimeeb](#):
>
> What is a need of the existing and potential pangeo community that the website can fill?

I would distinguish between the **general public website** vs. some sort of **technical user guides** (i.e. Pangeo Book). The general public website should introduce Pangeo to someone who has never heard of it. The technical user guides should be a place to aggregate the knowledge from this community. Perhaps the technical user guides, particularly around cloud, could be done in collaboration with ESIP and / or Pythia.

> [@aimeeb](#):
>
> Is it to help people get involved? Is it to understand how to deploy or use open science software? Is it to see examples of pangeo in action?

I think those are all possible goals for a visitor to the website. We should have a way to route people based on what they are looking for. Not to get too agile here, but would user stories help with this process?

> [@aimeeb](#):
>
> - Are any of those needs being met partially in other mediums?

[http://gallery.pangeo.io/](http://gallery.pangeo.io/) is supposed to be the place to see examples, although it could use some TLC (particularly since we had to restrict Pangeo binder usage). IMO this forum can also serve as an important knowledge base, particularly if we take some time to curate / aggregate useful posts.

---

<div class="post-metadata">

### Author: ![rabernat](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/rabernat/32/22_2.png) [@rabernat](https://discourse.pangeo.io/u/rabernat)
#### Post date: [March 9, 2022, 5:59pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/3 "2022-03-09T17:59:24Z")

</div>

@aimeeb - you asked about my the slides I shared at today’s meeting. They are online here:

> **[Pangeo OGC March 2022](https://speakerdeck.com/rabernat/pangeo-ogc-march-2022)**
>
> Presentation given at the March 2022 OGC meeting: https://portal.ogc.org/meet/?p=default&mid=88

Happy to share the Keynote version as well of that helps.

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [March 9, 2022, 6:56pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/4 "2022-03-09T18:56:04Z")

</div>

We had a lively discussion about this during the Pangeo Community Meeting just now ([Meeting Schedule and Notes — Pangeo documentation](https://pangeo.io/meeting-notes.html))

To recap what was discussed:

1. The high level goal for updating the website, and specifically the landing page, is to make sure we communicate an agreed upon definition of what Pangeo is and route expected audience for that page to other information they might be looking for
2. The low level goal for updating the website is to fix things that are out of date

We spent most of the time discussing the first objective “Who is the audience and what are they looking for?”

1. For the audience of folks that are completely new to Pangeo and need an answer to "What is Pangeo?” I would propose a section that conveys:

2. For the What is Pangeo? section, we may also want some diagrams to convey the messages listed above and the Pangeo community works on (“an opinionated?”) stack of tools, there is an abstract set of components and principles that describe any Pangeo solution.

3. For the audience of folks that are trying to find information on how to get started, example projects or how to get involved, we will want to identify those different types of users and guide them to what they need.

---

<div class="post-metadata">

### Author: ![clyne](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/clyne/32/748_2.png) [@clyne](https://discourse.pangeo.io/u/clyne)
#### Post date: [March 14, 2022, 6:48pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/5 "2022-03-14T18:48:15Z")

</div>

I just wanted to put in plug to please consider including [GeoCAT](https://geocat.ucar.edu/) in the list of core or affiliated packages. GeoCAT a growing collection of geoscience-specific data operators and plotting routines that consume (and typically produce) Xarrays. It is also Dask compatible. GeoCAT is developed and supported by NCAR with help from the earth sciences communities. Thanks!

---

<div class="post-metadata">

### Author: ![rabernat](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/rabernat/32/22_2.png) [@rabernat](https://discourse.pangeo.io/u/rabernat)
#### Post date: [April 8, 2022, 3:46pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/6 "2022-04-08T15:46:28Z")

</div>

I’m checking in on this effort. @aimeeb - how can we support your work on the website?

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [April 11, 2022, 3:30pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/7 "2022-04-11T15:30:07Z")

</div>

Hey @rabernat thanks for asking about how y’all can support. @annefou and I have started to generate some ideas and I would love to have some working sessions with Anne when I am in Europe May 11-June 6.

I am thinking that to get things started before then we can start working in parallel:

1. Every week, have a website working session. Alternating weeks, use this hour to either (1) reviewing the existing content and making issues for something that should be updated or removed or (2) updating content (i.e. working on tickets). We’ll have to see if this distribution of time to working sessions makes sense. How should this work with pangeo community meetings? Perhaps they could be extended to work on the website?

I can make the community meeting this week to kick this off.

1. Start working on re-organizing the site into 2 portals, one which is the **general public website** and another on **technical user guides**. I think this is where I need some advice on the design side. Should we have a landing page which acts as the general public site that just links to the technical user guides (where and how should those links be made clear).

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [April 20, 2022, 5:21am UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/8 "2022-04-20T05:21:21Z")

</div>

I have blocked time to make progress on the website questions Friday (I previously stated I would come up with a list for the community meeting tomorrow). Since I haven’t made progress and have some conflicting obligations tomorrow, I will join the next community meeting the 27th, apologies for the delay @rabernat I understand the website is a valuable asset to our community.

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [April 22, 2022, 9:18pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/9 "2022-04-22T21:18:35Z")

</div>

I made an inventory of the site which resulted in some minor text edits, but I would also like to go over some high and low level questions I captured [Pangeo Site Inventory - Google Docs](https://docs.google.com/document/d/1j0-tRgM0oUMjqEw8aVIpCzKGrLN41Br3uYYSqKfnc50/edit) and I’m hoping I can attend the Pangeo Community meeting next week to discuss. @annefou if you want to contribute comments async that would be super.

---

<div class="post-metadata">

### Author: ![annefou](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/annefou/32/2295_2.png) [@annefou](https://discourse.pangeo.io/u/annefou)
#### Post date: [April 25, 2022, 7:48am UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/10 "2022-04-25T07:48:10Z")

</div>

Thanks @aimeeb Your analysis of the website is great! I will add a few comments in your document but overall we are inline.

On my side, I have been looking at how other communities present themselves, what makes a community more inclusive and diverse, etc. I think it is also important aspects to take into account while restructuring the website.

I also think [Practical Tips to Build a Fantastic Community Homepage](https://www.feverbee.com/community-pages/) can be interesting for us to understand what to add and what to drop. I am looking forward to be working with you on the website.

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [May 24, 2022, 3:44pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/11 "2022-05-24T15:44:16Z")

</div>

@rabernat I know we discussed posting high level questions from the inventory document here, but I decided to open github issues for a few high priority issues, targeting the content on the home / landing page.

- Video: [Create a video for the home page "What is pangeo" · Issue #872 · pangeo-data/pangeo · GitHub](https://github.com/pangeo-data/pangeo/issues/872)
- Guides for core users: [Update homepage to point to guideance for our core expected user groups · Issue #873 · pangeo-data/pangeo · GitHub](https://github.com/pangeo-data/pangeo/issues/873)

---

<div class="post-metadata">

### Author: ![rsignell](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/rsignell/32/447_2.png) [@rsignell](https://discourse.pangeo.io/u/rsignell)
#### Post date: [August 25, 2022, 6:48pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/12 "2022-08-25T18:48:39Z")

</div>

I often show this people [this \<3 min video Matt Rocklin made for AMS in 2018](https://www.youtube.com/watch?v=rSOJKbfNBNk) to showcase the Pangeo tech stack.

It covers a lot of ground, and everyone has 3 minutes, right? 🙂

I know it’s not a good template for _the_ Pangeo intro video, but I think it would be great to have updated version of this!

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [August 26, 2022, 4:22pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/13 "2022-08-26T16:22:54Z")

</div>

This is a great example of jumping straight into answering the question of “What is Pangeo and why pangeo” from the tech stack perspective. I definitely think we can copy that example of jumping quickly into a notebook environment and explaining that the tech stack the pangeo community works on promotes data-proximate computing resources and libraries like Zarr, Dask and xarray to perform lazy loading and distributed analysis. I think what we might add is some beginning and / or end explanation about how Pangeo is a community and an ecosystem and how folks can get involved.

---

<div class="post-metadata">

### Author: ![aimeeb](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/aimeeb/32/215_2.png) [@aimeeb](https://discourse.pangeo.io/u/aimeeb)
#### Post date: [September 4, 2022, 10:40pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/14 "2022-09-04T22:40:50Z")

</div>

@paigem and I made great progress today, we:

Paige created an example of what the new homepage could look like (Paige to add link to issue and screenshot)

We also worked on content for a video for the homepage:

- started a set of slides: [Pangeo Website introduction - Google Slides](https://docs.google.com/presentation/d/1iW96WVBLF93DLeOH-sPAsTgcG5O5zTx85Z5a4BMYno8/edit?usp=sharing)
- Started a demo notebook, which is linked in the slides but I’ll link again [pangeo/PANGEO-DEMO.ipynb at ab/pangeo-demo · pangeo-data/pangeo · GitHub](https://github.com/pangeo-data/pangeo/blob/ab/pangeo-demo/notebooks/PANGEO-DEMO.ipynb)

Next steps for video:

- Revisit the content in the intro slides with whomever has input
- Refine the content in the pangeo demo (or start from scratch)
- Create the narrative
- Create a rehearsal video
- Get volunteers to participate in the video

---

<div class="post-metadata">

### Author: ![paigem](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/paigem/32/812_2.png) [@paigem](https://discourse.pangeo.io/u/paigem)
#### Post date: [September 4, 2022, 11:05pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/15 "2022-09-04T23:05:37Z")

</div>

[Here is the PR](https://github.com/pangeo-data/pangeo/pull/878) with a suggested update to the Pangeo homepage (or at least a first attempt at such an update!). Please feel free to comment and edit! We intend for this first draft to be a conversation starter from the community on how we can improve our website’s homepage.

Below is a screenshot of our suggested homepage update (keeping in mind that I am new to rst and so the formatting can certainly be improved upon!). Rationales for all our choices are indicates in the PR linked above.

 ![Screen Shot 2022-09-04 at 18.24.57](https://canada1.discourse-cdn.com/flex030/uploads/pangeo/original/2X/8/88f701fbd3f57d0bfacbd288ac29aaed48e20827.jpeg)

Huge thanks to @aimeeb for joining me today for this in-person hack! 😄

---

<div class="post-metadata">

### Author: ![geynard](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/geynard/32/2924_2.png) [@geynard](https://discourse.pangeo.io/u/geynard)
#### Post date: [September 5, 2022, 12:45pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/16 "2022-09-05T12:45:26Z")

</div>

Thanks @paigem and @aimeeb for your great work! I’ve added some comments to the slides. The main one would be to check (if not already done) @rabernat slides, in particular [Pangeo OGC March 2022 - Speaker Deck](https://speakerdeck.com/rabernat/pangeo-ogc-march-2022). I’m sure Ryan would agree to share content. There are great slides or ideas in there you could probably reuse!

I’ll try to have a look at the rest too!

---

<div class="post-metadata">

### Author: ![geynard](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/geynard/32/2924_2.png) [@geynard](https://discourse.pangeo.io/u/geynard)
#### Post date: [September 5, 2022, 12:57pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/17 "2022-09-05T12:57:33Z")

</div>

About the demo notebook, why not use some existing content from Pangeo Gallery? There is probably some simple enough and nice notebook to use there?

My go to example when I wanna show Pangeo is [Sea Surface Altimetry Data Analysis — Pangeo Gallery documentation](http://gallery.pangeo.io/repos/pangeo-gallery/physical-oceanography/01_sea-surface-height.html).

I think an important point would be that the notebook should be easily reproducible by a new user. Currently with Pangeo binder shut down, it’s difficult to have a scalable enough environment…

---

<div class="post-metadata">

### Author: ![maxrjones](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/maxrjones/32/3190_2.png) [@maxrjones](https://discourse.pangeo.io/u/maxrjones)
#### Post date: [September 9, 2024, 3:25pm UTC](https://discourse.pangeo.io/t/how-should-we-update-the-pangeo-website-to-better-serve-the-community/2295/18 "2024-09-09T15:25:55Z")

</div>

for anyone tracking the website update conversation, I wanted to [share a copy of this post](https://github.com/pangeo-data/pangeo/issues/922#issuecomment-2338352255) from the similar [github issue](https://github.com/pangeo-data/pangeo/issues/922). Please comment there with feedback 🙏

> In addition to a lot of the website’s contents being out of date, this repository is also unlicensed and would be difficult to re-license at this point due to the large number of contributors. I would like to propose that we start afresh with a new website and gradually add pages necessary based on the currently relevant information from the new website.
> 
> **Proposed website start** (forked from xarray.dev): [maxrjones/pangeo.io](https://github.com/maxrjones/pangeo.io)  
> **Deployed proposed website** : [pangeo-io-git-main-max-jones-projects.vercel.app](https://pangeo-io-git-main-max-jones-projects.vercel.app/)  
> **Proposed timeline** :  
> September 9 - Max fills out the rest of the meeting / showcase pages  
> September 9 - 18: Solicit feedback on framework, decide whether to move forward with a new website  
> September 18 - October 8: adjust high-level plan for the website content based on steering council meetings, update sponsorship page  
> (if we decide to move forward with the new website)  
> October 8: migrate [maxrjones/pangeo.io](https://github.com/maxrjones/pangeo.io) to pangeo-data github oganization  
> October 8 - October 31: add new pages as neededwith at least one week for review on each page  
> October 31: Deploy at [pangeo.io](http://pangeo.io), publish a blog post announcement
