[Video Uploads Page] Show & Upload transcripts

The purpose of this document is to record the assumptions and decisions made prior to build this feature.


EDUCATOR-1736 - Getting issue details... STATUS

Initial prototype for showing & uploading transcripts on Video Uploads page: http://jrpb2q.axshare.com/v1.html


Background


Video transcripts were initially uploaded via video component settings and stored in contentstore. Transcript uploaded were shown on video component using the transcripts or Assets page. Then video transcript generation was introduced on Video Uploads page using automated third party transcript providers.


Problem statement

The transcript uploaded via Video Uploads page would not be shown on Assets Page. We needs to show the transcript that was generated using third party transcript provider on some place.

Now we have two sources from where transcripts can be uploaded or generated.

  • Video Uploads page.
  • Using Video Component
    • Previously transcripts were stored to contentstore, After phase 2, transcripts would be uploaded to S3.

Approach

We will only show transcripts that are being uploaded to S3 (Automated 3rd party transcript provider generated transcripts + S3 uploaded via video component + uploading an existing transcript on Video Uploads page.)

Why we adopted it?

  • While previous transcripts were stored in contentstore, now we are storing to S3 and would be soon deprecating storing to contentstore. It makes sense to show transcripts generated via automated 3rd party providers on Video Uploads page.
  • In contentstore implementation, an edX video id can be used in multiple video components, every component can store language specific transcripts attached to it. So if we are going to show both S3 and contentstore transcripts then we can have a problem where we would have multiple transcripts for one language against a video id. (Eg. 3 English transcripts, 1 Spanish, 2 Chinese for edX video id xyz-xyz-xyz-xyz). But this issue would not happen if we just show S3 uploaded transcripts.
  • After transcript phase 2 is complete, transcripts would be upload to S3, so those would also be shown on Video Uploads page.
  • When contentstore transcripts are migrated, then we would have all the transcripts on S3 and all would be shown Video uploads page against their respective video ids.

Decisions

Following decisions were made to rollout basic MVP of Show & Upload Video Transcripts on Video Uploads page as discussed between Mushtaq Ali (Deactivated) and Shelby Quinn (Deactivated).

  • We can go with minimum UI change for now.
  • Show transcripts uploaded. (if more than 3 transcripts show "More" button - which can be expendable) -  EDUCATOR-1662 - Getting issue details... STATUS
  • Clicking on transcripts should download them -  EDUCATOR-1853 - Getting issue details... STATUS
  • We can re-upload the existing transcript (this will override the previous lang-specific transcript) -  EDUCATOR-1854 - Getting issue details... STATUS