add-video

name	add-video
description	Instructions for adding a new video (talk, keynote, or podcast) to the repository

Adding a New Video

To add a new video (talk, keynote, or podcast) to this repository, you need to update two files: index.html and atom.xml.

1. Update index.html

Add a new <li> element inside the <ol class="talks"> list in index.html. The new entry should be added at the top of the list (right after <ol class="talks">).

Template for a YouTube video:

			<li type="talk">
				<a href="https://www.youtube.com/watch?v=VIDEO_ID">
					<figure>
						<img src="https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg" alt="Video thumbnail">
						<figcaption>
							TITLE
							<br>
							<small>EVENT</small>
						</figcaption>
					</figure>
				</a>
			</li>

Specific Guidance for index.html:

• type attribute: Must be exactly talk, keynote, or podcast (use the singular form so CSS filters work correctly).
• URLs with Timestamps: For keynotes or specific segments in longer videos, append a timestamp to the YouTube URL (e.g., &t=2480 or ?feature=shared&t=3976).
• Thumbnails:
  • For standard YouTube videos, use https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg.
  • For podcasts or videos lacking a good default thumbnail, save a .webp image in the images/ directory and reference it like src="images/your-custom-image.webp".
• Alt Text: Include descriptive alt text on images, such as alt="Video thumbnail" or alt="Interview thumbnail".
• TITLE: The title of the talk/podcast.
• EVENT: The name of the event (e.g., "Cloud Next 2025", "Google I/O 2025", "Screaming in the cloud").

2. Update atom.xml

Add a new <entry> block to the Atom feed in atom.xml. The new entry should be placed at the top of the feed entries, immediately preceding the existing <entry> tags. Also, remember to update the <updated> timestamp of the main feed.

Template for the entry:

  <entry>
    <id>https://www.youtube.com/watch?v=VIDEO_ID</id>
    <link rel="alternate" href="https://www.youtube.com/watch?v=VIDEO_ID" />
    <title>TITLE</title>
    <updated>YYYY-MM-DDT00:00:00Z</updated>
    <summary>EVENT</summary>
  </entry>

Specific Guidance for atom.xml:

• id and link href: Use the full URL (e.g., the YouTube link or the podcast URL, including timestamps if applicable).
• summary: Use this field for the name of the event (e.g., "Cloud Next 2025"), which matches the <small> tag in index.html.
• TITLE: The title of the talk/podcast.
• YYYY-MM-DD: The date the talk was given or published.

Update main feed timestamp: Find the main <updated> tag near the top of the file (before the first <entry>) and update it to the current date or the date of the new video:

  <updated>YYYY-MM-DDT00:00:00Z</updated>