hhrutter / transcripts

Changelog episode transcripts in Markdown format 📚

Changelog Transcripts 📚

The repository of Changelog episode transcripts in Markdown format.

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

Contributors

Thanks goes to these wonderful people (emoji key):

alexandrumaier 📖	Jerod Santo 📖	Brian Boucheron 📖	chris48s 📖	Taylor Murphy 📖	ComodoHacker 📖	Peter Merikan 📖
Casey Wilson 📖	Edouard Duplessis 📖	Peter Mortensen 📖	Illarion Koperski 📖	Todd Gamblin 📖	Todd Rafferty 📖	Dmitri Shuralyov 📖
Matt Warren 📖	Dotan Dimet 📖	Shari Hunt 📖	Sharang Dashputre 📖	Jared Dillard 📖	Tommy Williams 📖	Navan Chauhan 📖
David J. Felix 📖	Balazs Nagy 📖	Jacob Kiers 📖	Tom Harvey 📖	Carlos Alexandro Becker 📖	Ken-Lauren Daganio 📖	Horst Rutter 📖
Bradley Kemp 📖

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

Contributing

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

• Replacing the keyword 'unintelligible' with the correct word/phrase
• Adding links to referenced URLs, projects, etc.
• Adding timestamps to key/beloved statements and sections
• 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 transcripts 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 transcript in this repo at: rfc/request-for-commits-13.md

Text Formatting

Each transcript fragment is parsed as 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 transcripts much more useful to readers and provide valuable SEO juice to the link-worthy things we discuss on our shows.

Timestamps

Timestamps appear inline in front of the word/phrase they attach to. The preferred placement is at the beginning of a speaker's sentence/thought. Timestamps are delineated in the transcript by square brackets and HH:MM:SS.ms format. Because the text is in Markdown format, the square brackets must be escaped using a backslash \ character. Example: \[00:04:01.06\]

The hour and sub-second sections are optional. This is another valid timestamp: \[04:01\]

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.