thechangelog/show-notes

Changelog episode show notes in Markdown format 📝

Changelog Show Notes 📝

The repository of Changelog episode show notes in Markdown format.

• Contributors
• Contributing
  • Why Contributing Is Worth Your Time
• Conventions
  • Directory structure and file names
  • Text Formatting
  • Timestamps
• Guidelines
• Conduct
• License & Copyright

Contributors

Thanks goes to these wonderful people (emoji key):

Jerod Santo 💻 📖	JoeBew42 💻	Cody Peterson 📖	Horst Rutter 📖	Sanyuj Gupta 📖	Stacy Montemayor 📖
Timothy Miller 📖	dharmendra-lingaiah 📖	Mr-Fusion 📖	Sung Kim 📖	Brett Cannon 📖	Maria Kaninia 📖
Niklas Resch 📖	SeanYeoTE 📖	atlapse 📖	Zachary Bouzan-Kaloustian 📖	Gabriel Viveros-Goldammer 📖	Syed Zeeshan 📖
anton 📖	Pablo Nevares 📖	Nabeel Sulieman 📖	Solomon Victorino 📖	Eduardo Arango 📖	Povilas Versockas 📖
Victor Zhou 📖	Kévin Etienne 📖	Jan Vlnas 📖	Nathan Fixler 📖	Jordan Eldredge 📖	Ned Batchelder 📖
Syrus Akbary 📖	Tim Burke 📖	Johan Brandhorst 📖	Agano oasis 📖	NILANJAN TARAFDER 📖	mtayllan 📖
Atef Ben Ali 📖	Scott Ratigan 📖	Ed Brannin 📖	neX 📖	Dan Herrero 📖	Pritam Singh 📖
Dávid Paksy 📖	Angelica Omaiye 📖	Rajat Varyani 📖	Marin Ivanov 📖	Kyle 📖	Siôn le Roux 📖
Anand Bambhania 📖	Abhishek Gupta 📖	Lauren Tan 📖	Kemal Akkoyun 📖	Duane O'Brien 📖	Feross Aboukhadijeh 📖
Calaway 📖	Hedy Li 📖	Marko Schulz 📖	rsynnest 📖	Shane Keulen 📖	Steve Coffman 📖
Arushi Agarwal 📖	jsilvers 📖	VM Brasseur 📖	Christopher Hunter 🖋 📖	Justin Juno 📖	Kevin Ernst 📖
Mae Capozzi 📖	Matthew Boehlig 📖	ferdymercury 📖	Rocky Kev 📖	Sudeep Biswas 📖	Maikel 📖
Mohamed Ziata 📖	Owen Valentine 📖	Robert Purcell 📖	Filip Seman 📖	Burhan Khalid 📖	pkdyn 📖
Cheese 📖	Ricky de Laveaga 📖	Phill Zarfos 📖	Felix Ingram 📖	Msquared 📖	Jason Keene 📖
Alice 📖	Justin Searls 📖	Max Greenwald 📖	Jack M. 📖	Peter Tripp 📖	Uilian Souza 📖
oneoneonepig 📖	Lars Ellingsen 📖	Abi Noda 📖	Jody 📖	frodera 📖	tripleee 📖
Vedran Kolka 📖	Harlan T Wood 📖	Jamie Tanna 📖	Brendon Smith 📖	Jason McCallister 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

Contributing

Pull requests, please! Our show notes are lovingly crafted by humans, but they're nowhere near perfect. Specific things we'd love help with:

• Fixing broken links
• Adding links to referenced URLs, projects, etc.
• Fixing typos

Why contributing is worth your time

1. Once merged, your contribution will immediately (pending webhook execution) appear on the episode page for all to use/enjoy!
2. We routinely send thank you's on the air and on Twitter!
3. Give back to the awesome Changelog Community of hackers, podcast hosts, and guests!

Conventions

Directory structure and file names

Parsed and html-ized versions of these show notes live on Changelog.com alongside their respective episode, which is accomplished by following this naming convention:

[podcast-slug]/[hyphenized-podcast-name]-[episode-slug].md

For example, the episode that lives at: https://changelog.com/rfc/13

Has its show notes in this repo at: rfc/request-for-commits-13.md

Text formatting

Our show notes are authored good ole' Markdown. That means you can add *s or _s for emphasis, [links](https://changelog.com) to referenced people/projects, etc. We especially encourage addition of links. These make the notes much more useful to readers and provide valuable SEO juice to the link-worthy things we discuss on our shows.

Guidelines

• Frequently our show notes are prepared before recording and sometimes prepared links don't make it into the show for one or another reason. If you happen to notice one of these zombie links our policy is to remove them.

• Occasionally links for streaming content stop working because of media copyright issues. We also want to get rid of those.

Conduct

Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License & Copyright

Creative Commons Attribution Share Alike 4.0. Copyright Changelog Media LLC.

show-notes's Issues

Can we have transcript for changelog-337

changelog-337

Policy regarding show note items

Many times the show notes are prepared prior to recording
and sometimes prepared links don't get mentioned in the show for one or another reason.

What's our policy regarding these links. Should we scratch them so that the show notes only reflect items mentioned during the show or leave them in anyway.

eg. the GoTimeFM team sometimes prepares links to interesting projects that don't make it into the show due to lack of recording time.

JS Party #287 — Val Town’s use of “were” is correct

I no longer use any of the other social media platforms you folks inhabit, so I have to mention this here.

I’m listening to JS Party #287, “Take me to Val Town.” About two-and-a-half minutes into the episode, Amal teased Val Town’s Steve Krouse about the use of “were” next to a singular item (“AWS Lambda”) in the Val Town website’s headline. However, Val Town is correct in using “were” in this case because it’s an “unreal conditional.”

For example: if I go outside on an extremely hot day and walk barefooted on the sidewalk, I could correctly say, “If this sidewalk were air-conditioned, my feet wouldn’t be hurting right now.”

Broken link

The link to the "Urgency Importance Matrix" in https://github.com/thechangelog/show-notes/blob/master/jsparty/js-party-187.md is broken.

of course its possible to search for the topic, but there are quite some different resources on the topic.
Might make sense to link to some resource (maybe a website on the topic, not just an image) that is aligned with the previously linked image.

chore: missing links in Don't make things worse episode

The last two Youtube links in the show notes for this episode link to youtube.com/watch instead of the Youtube videos referenced by the links. I believe the links should be:

• https://youtu.be/GRr4xeMn1uU
• This one is tricky and does not seem to be online anymore - https://web.archive.org/web/20201101001905/https://vimeo.com/108441214
• There is this Gitlab page that seems to share some notes from the video: https://gitlab.com/vargavince91/yt-notes/-/issues/1

Happy to send a PR if we can agree on what to link to.

Improve our show notes

1. Pick an episode of a Changelog podcast from changelog.com/podcasts and find the corresponding markdown file in this repository: github.com/thechangelog/show-notes
2. Listen to the podcast and improve the show notes by:
   • Fixing broken links
   • Adding links to referenced URLs, projects, etc.
   • Fixing typos
3. Submit a PR with your changes

Broken link

podcast/the-changelog-368.md

The FindCollabs link no longer works

Misspelling in Typesense sponsore

Not sure if this is a good place to report this, but I think there may be a typo in the Typesense Ad for the past couple episodes of Go Time.

Typesense – Lightning fast, globally distributed Search-as-a-Service that runs in memory. You iterlly can’t get any faster

Should iterly be literally? Maybe it’s a pun that I don’t get, but I thought I’d mention it just in case.