Managing Events

Once you have confirmed a Web We Want session for an event, you will want to add it to the site. You do this by

1. Creating a new file in the events folder.
2. Name it following the convention of YEAR-name-of-event.md. If the event happens in multiple locations, add the location to the name. For example: 2019-an-event-apart-dc.md.
3. The file will be entirely YAML front matter. Paste in this template and update accordingly:

---
title: "An Event Apart"
url: https://aneventapart.com/event/washington-dc-2019
location: "Washington DC, USA"
start_date: 2019-07-29T08:00:00
end_date: 2019-07-31T18:00:00
zone: "America/New_York"
---

• title - The name of the event.
• url - URL to the specific event WWW will be presented at.
• location - Location, including region as necessary (e.g., "Washington DC, USA" or "Berlin, Germany")
• start_date - Date and time the conference starts
• end_date - Date and time the conference ends
• zone - Timezone in which the event takes place

4. If someone is sponsoring prizes to the winners, please add the sponsor key. For example:

sponsor: Microsoft Edge

5. Validate your YAML.

Once you publish or edit your file, you should see your event updated on the site within about five minutes.

Adding Judges & Hosts

When you have locked down the host(s) and judging panel, please update the event by adding the people to the front matter. We use two keys in the front matter for this: hosts and judges. Each is a list of people and each person is an object consisting of the following keys:

• name
• url - If they have a website, include it; this is optional
• twitter - If they use Twitter, include their handle (without the @ symbol); this is optional

When you put it all together, you should end up with something like this:

hosts:
  - name: Aaron Gustafson
    url: https://www.aaron-gustafson.com
    twitter: aarongustafson
  - name: Stephanie Drescher
    url: https://stephaniestimac.com/
    twitter: seaotta
judges:
  - name: Rachel Andrew
    url: https://rachelandrew.co.uk/
    twitter: rachelandrew
  - name: Sarah Drasner
    url: https://sarahdrasnerdesign.com/
    twitter: sarah_edo
  - name: Jen Simmons
    url: https://jensimmons.com/
    twitter: jensimmons

Adding Presented Wants

When you have decided on which "wants" will be pitched at the event, you should add them to the pitches list by including the unique id of the wants (i.e., the file name without the extension), ideally in the order they’ll be presented:

pitches:
  - 5
  - 7
  - 5e52722b13def22bf8bfd348

Adding the Winners

When the judging is complete, you will want to update the event so we can track the winners. This is done via the winners object. As with the pitches, you only need to supply the unique id of each of the winning wants:

winners:
  judges: 4
  community: 12

Validate your YAML

To ensure nothing breaks when you publish, please be sure to validate your YAML. YAMLlint is a good service for this. Once you publish or edit your file, you should see your event updated on the site within about five minutes.