links

README.md

@@ -94,6 +94,8 @@ The url for that feed is:  [https://noagendaassets.com/enc/pc20sandbox.xml](http
    specified by the RSS \<language\> element.  If the rel="captions" attribute is present, the linked file is considered to be a closed captions file, regardless of what the
    mime type is.  In that scenario, time codes are assumed to be present in the file in some capacity.
 
+   A fuller explanation of the file format expected by the `<podcast:transcript>` tag is detailed [here](transcripts/transcripts.md).
+
 <br>
 
 - **\<podcast:funding url="[url for the show at the platform] platform="[service slug]">**[user provided content to link]**\</podcast:funding>** (formalized)

transcripts/transcripts.md

@@ -1,6 +1,11 @@
+## Transcript File Format Details
+
 This is the initial spec for the podcast transcript format.  There are three possible formats detailed below.
 
 
+<br><br>
+
+
 ## HTML
 
 The HTML transcript format provides a solution when a transcript is available but no or limited timecode data is available. HTML transcript files are considered low-fidelity and are
@@ -21,6 +26,8 @@ designed to serve as an accessibility aid and provide searchable episode content
 <p>You're triggering Tom right now with a hey, here's a cool feature.</p>
 ```
 
+Example file:  [example.html](example.html)
+
 <br><br>
 
 
@@ -75,6 +82,8 @@ The JSON representation is a flexible format that accomodates various degrees of
 }
 ```
 
+Example file:  [example.json](example.json)
+
 <br><br>
 
 
@@ -125,3 +134,5 @@ here from breaking through
 careers podcast. My question is,
 do we need a podcast trailer?
 ```
+
+Example file:  [example.srt](example.srt)