Skip to content

New Episode Workflow

Paul Cutler edited this page Aug 8, 2024 · 1 revision

New Episodes

Planning & collaboration

In the _drafts folder is episode_template.md - this file should be copied as {episode#}.md for the next episode. There we can jot down any notes, links, or news items for that episode. This file serves as the basis for the show notes.

Show Notes

After recording the episode, to prepare the show notes:

  1. Create a new branch (we can standardize on a branch name like episode1, 1, or by date)
  2. Create a new directory in `/content/en/blog/episodes/{episode#}
  3. In the _drafts folder I've created an episode-template.md file. Copy that file as {episode#}.md into the new directory.
  4. Copy and paste the content from the episode draft in the _drafts folder into the new markdown file.
  5. Copy any photos used in the episode or show notes into the same directory
  6. Update the front matter and include a featured photo (if any) to display on the Episodes page
  7. Run hugo serve locally to check formatting
  8. Push
  9. PR to main when episode is ready to go live
  10. Merge will build and auto-deploy site

Clone this wiki locally