User:Aardvark/TranscriptWorkflow

From The Portal Wiki
The Portal Transcripts (Transcript Completion Project)
Portaltranscript.png
Information
Topic The Portal Podcast
Leader pyrope#5830
BeefSandwich27#0143
Aardvark#5610
Start Date 31 January 2020
Methodology Transcript Workflow
Style Guide Wiki Page
Portal Media Spreadsheet Sheet
Google Drive Drive
Links
Website The Portal Blog
Discord Link
The Portal Group Discord Link
All Projects

This is the workflow for generating and editing transcripts for The Portal Podcast and other Content by Eric Weinstein. It introduces the tools we use, our style guide, and our process.

Before you start

There are a couple things you should know before starting. Also check that there isn't already a transcript for what you would like to contribute to, using our sheet, the wiki categories, or the blog.

Make accounts

In order to give you access to our transcripts, you'll need accounts with the services we use.

  • Have a Discord account. Discord is an online chat service where we coordinate our work.
  • Have an Otter.ai account. We generate our transcripts in Otter, where they can be edited to match speakers to text.
  • Have a Google account. We use Google Drive and Google Docs to store and coordinate our work.

Contact us on Discord

Contact Aardvark or Brooke on our transcript-focused Discord server or our main Discord server. Say what you'd like to work on and we'll give you access to our Drive folder and the AI-generated transcript in Otter.

Basic Editing Rules

We have developed a style guide to keep our transcripts consistent. Here are the basics.

  • We use American English.
  • We use a clean verbatim style. This means filler words (ums/uhs) and repeated words or phrases, when they do not add meaning or nuance, are removed.
  • Paragraphs are not indented.
  • Leave an empty paragraph between paragraphs.
  • Timestamp on top, italicized, shift+enter for line break (not paragraph break from regular enter).
  • Speaker tags are bold, punctuated with a colon, and use the speaker's full name (first + last).
  • Only the first of consecutive paragraphs by a speaker should have a speaker tag.
  • Add notes in brackets for things that happen in video but don't translate to audio.
  • Add section headings

Be sure to review our style guide for everything in detail with examples.

Editing Process

Some people prefer doing the majority of their editing in Otter, while others prefer Google Docs. Both are necessary, but you are free to use them as best suits your preferences.

  1. Edit in Otter
  2. Edit in GDocs while listening
  3. Edit in GDocs again

Using Otter

Using Google Docs

  • Disable smart quotes
  • Disable substitutions
  • Using headings
  • Leave comments where you're uncertain

When finished

Tell us! We'll look it over and put it on the blog.

Putting it on the wiki

Paste it onto the wiki. Note that

  • Timestamps must be followed by a <br> tag to insert the linebreak.
  • Perform a find/replace operation with each speaker name, replacing the speaker name with the name surrounded by three tick marks. So Eric Weinstein: is replaced '''Eric Weinstein:'''.
  • Add the necessary markup around section headings. Keep in mind heading levels may differ between the Google doc and the wiki, all that needs to be preserved is.

Also add the transcript blurb template.

For more help on using the wiki, see Wikipedia's guide on Wiki markup and our Wiki Usage FAQ.

If I don't want to continue working on a transcript

Tell us!