Pulp

# Demo Presenter Notes

A Pulp demo is a five minutes or less video of something accomplished that affects Pulp, a Pulp plugin, or the Pulp community. Presenters can be anyone from the community.

## When do I need to record a demo?

If you are raising a Pull Request with substantial changes to any element of the Pulp project, you must include a demo of your changes with your pull request. If you deem your changes too small to be worthy of a demo, state that in the body of the PR. Note that the reviewers might request a demo if they think it will help the community better understand the changes.   

## Demo length

All videos must be under 5 minutes. The ideal demo length being about 3 - 4 minutes based on the [Wistia report](https://wistia.com/blog/does-length-matter-it-does-for-video-2k12-edition).

## Recording a Video

Although audio is welcome, it is not a requirement. 

You can use a tool like [simplescreenrecorder](http://www.maartenbaert.be/simplescreenrecorder/) or [recordmydesktop](http://recordmydesktop.sourceforge.net/about.php) to record both audio and video at the same time. [OpenBroadcasterSoftware](https://obsproject.com/) is also a good choice, but more heavyweight and fully featured than those two. 

Whatever you use, ensure that you:

1\. Increase the font! Whatever you think is readable, make it a lot bigger.  

2\. If your video has audio, check your audio level. We can't fix audio that is recorded too soft or too loud when we playback the video.

## asciinema

You can also use [asciinema](https://asciinema.org/) to record your demo. 

When using asciinema, it's important to set your terminal size so that the video output for all demos is consistent. 

Before you begin your demo, please set your terminal size to 90x45 characters. 

In order to automate and properly anonymise asciinema generation, you can add it to the [saftladen](https://github.com/mdellweg/saftladen) repository.

The asciicasts generated there can be uploaded to [asciinema](https://asciinema.org/) to be embedded in any kind of web content.

## Testing your Video

All video playback happens in Firefox. Ensure that a normal Firefox browser can natively play your video.

## Sending your video:

1\. Come up with a title that is 50 chars or less.  

2\. Come up with a description. It can be one or more paragraphs.  

3\. Send the recorded video as an attachment, along with the title, and description to mcorr@redhat.com. Alternatively, you can send a link to download the video file from or a link to asciinema. By submitting a video you are acknowledging you are the copyright owner of that video content and you agree to grant Pulp the right to broadcast and playback that content.