kubernetes / contributor-site

Code for kubernetes.dev
https://www.kubernetes.dev
Apache License 2.0
64 stars 153 forks source link

Re-arrange Contributor Summit to be self-archiving #316

Closed jberkus closed 2 years ago

jberkus commented 2 years ago

How it is now:

Currently the contributor-summit section of the website looks like this:

events/
  kseu/
past events/
  2021/
    kseu/
    ksna/
  2020/

... this means that we have to go through a process of "archiving" each Summit, which not incidentally breaks any links anyone made to the original summit pages.

What we should have is something like this

events/
  summits/
     2022/
       eu/
       na/
     2021/
     2020/
  other/
    2022/
    2021/

events/_index.md would have a list of upcoming events (manually updated, unless we have a way to automate it)

summits/_index.md that would redirect people to the current Summit.

events/other is for any "other" contributor events. Currently we don't have pages for anything else, but we might in the future.

@mrbobbytables @Atharva-Shinde

jberkus commented 2 years ago

/kind/feature

Atharva-Shinde commented 2 years ago

/kind feature looking into it 👀

Atharva-Shinde commented 2 years ago
events
  others
    2020/kcc
    2021/kcc
    2022/empty
  summits
    2020
      eu/empty
      na/empty
    2021
      eu/empty
      na/kcs
    2022
      eu/kcs
      na/empty

This is how the structure looks after rearranging, based on the contents in this repo.

jberkus commented 2 years ago
    2022
      eu/kcs
      na/empty

I don't think we need to have a subdir below 2022/eu/ here. There's only going to be one summit per region per year.

Agreed that we do need subdirs for "others" though.

mrbobbytables commented 2 years ago

IMO - we can probably simplify things with

events
  2022
    kcseu
    kcsna
  2021
    kcsna
    kcc
  2020
    kcc

we then move community meeting to the community section, we can remove office hours and MoC as they are essentially not happening anymore.

EDIT: We should move forward with this soon before we things pick up with kcsna2022

jberkus commented 2 years ago

So, shallower events/ with just year and then long event name? Sure.

BTW, what I was thinking of for "others" was, for example, any KCD that has a contributor event attached. But there's no reason we can't work that into your structure.

Where would the permanent summit landing page be located, then? events/summit.md?

palnabarun commented 2 years ago

Should we preserve links to existing events? People may be referring to them as permalinks, for example, a link from social media to the Contributor Celebration > Contributor Awards page.

jberkus commented 2 years ago

I don't think it's worth the effort to preserve the links. These are, well, events, and people generally stop caring about them after the event is over.

jberkus commented 2 years ago

So, modifying Bob's tree and adding files:

events/
  _index.md --> listing of current and recent events
  2022/
    kcseu/
      contents of current events/kcseu/
    kcsna/
      new folder, blank templates
  2021
    kcsna
      contents of events/past-events/2021/kcsna
    kcc
      contents of events/past-events/2021/kcc2021
  2020
    kcc
      contents of events/past-events/2020/kcc2020
mrbobbytables commented 2 years ago

summit.md isn't needed, the most current summit just needs summit listed as an alias in its frontmatter to work 👍

jberkus commented 2 years ago

changed.

Atharva-Shinde commented 2 years ago

/assign