Creating courses and tutorials (Knowledge Transfer process)

DRAFT DOCUMENT

This article describes the KT and how to develop a course. Learn how to start the Knowledge Transfer process, create the course assets, and upload a video to the Media Publishing Cloud (MPC).

What is a Knowledge Transfer (KT)?

When engineering starts a feature, the product manager creates a corresponding wiki (KT). The KT is where everyone shares knowledge about a product or feature. Engineering creates an associated task, which includes Epics and Stories that track progress.

KT Structure

Epics correspond to features. Stories correspond to the content (tasks) and deliverable types you author or create (video, article, course, etc.). All the wiki page watchers are notified when questions are raised or updates added to wiki.

Creating and uploading video

The video How to create and upload a video provides an example (using AEM Commerce) on this process.

  1. Create a Jira story.

  2. Record the video:

    1. (Optional) create a script.
    2. If scripting, you can record the audio in Audition.
    3. You can record video with QuicktTime.
  3. Edit the video in Premiere Pro.

  4. Upload the video to Media Publishing Cloud (MPC), setting metadata fields and chapters when appropriate.

    You’ll need permission to upload to MPC.

  5. Create a thumbnail (for each asset) from the posters page.

    1. Save image from posters page.
    2. Open the image in Photoshop and save at 400 x 225.
    3. Upload the thumbnail to Sharepoint.
  6. Create a thumbnail for course (also used in CaaS).

  7. Create a Git branch if needed.

  8. Fetch the branch from Git in GitHub Desktop.

  9. Using VS Code, create the Markdown file with all the proper metadata.

  10. Add the file to the repo’s TOC.

  11. Push the new/edited files to GitHub.

  12. Do a Pull Request to the Master branch, if you used a different branch.

  13. You should get a message from sccm-bot in Slack, and you can view/check the files on experienceleague.corp.adobe.com via the link in Slack.

  14. Click Publish in Slack and initiate the publishing process in Jenkins. When it is done, it will be live in ExL.

  15. Fill in the final fields in Jira, including:

    • Set the Publish link to the public URL
    • Duration
    • Description
    • Create a link to the Github page
    • Create a link to the MPC video embed code
    • Mark the ticket as Done

Uploading Videos to Adobe TV

COPIED FROM writer-resources.md - Reconcile with above

When creating videos for users, upload the videos to Adobe TV. Do not use YouTube, Vimeo, or another third-party platform.

Sean Schnoor’s team manages video content for Experience Cloud. Before you create a video, check with Sean or a member of Sean’s team to make sure that you have access to the proper location within Adobe Media Publishing Cloud (MPC) and that you avoid duplicating existing content.

  1. Create a KT Story in the KT project for each video.

    Here’s an example KT Story. Adding the KT Story will prompt the localization team to pick-up the video and add subtitles and TTS.

  2. When storing a video for AEM in MPC it should go in a newly created folder in the Help & Support > Experience League bucket.

    There should be a 1:1 mapping of folder to English video. The folder name should be the exact same name as the video file.

  3. Navigate to Adobe Media Publishing Cloud.

  4. Navigate to the folder where you want to add the video.

    You will need to have proper access and permissions to upload videos. Contact Sean Schnoor or his team for details.

  5. Click the upload icon from the top right corner.

    upload video 1

  6. Drag and drop the videos to the dialog box or click to browse to your local location of the video. Add the title and description to your video.

    upload video 2

  7. Once the upload is complete, click on Get Code under Embed Codes to access the publish link.

    upload video 3

  8. Copy the link to the video from the Shareable Link, as shown below.

    upload video 4

  9. Once you have the link, you can share the link or add the specific video to your documentation with the following syntax:

>[!VIDEO](https://video.tv.adobe.com/v/28380)

If you have questions about uploading videos, contact Sean Schnoor or a member of his team.

On this page