Project

Profile

Help

Demo Presenter Notes » History » Sprint/Milestone 12

mcorr, 11/24/2020 09:59 AM

1 1 bmbouter
# Demo Presenter Notes
2
3 10 mcorr
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.
4 1 bmbouter
5 10 mcorr
## When do I need to record a demo?
6 1 bmbouter
7 10 mcorr
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.   
8 2 bmbouter
9
## Demo length
10 1 bmbouter
11 2 bmbouter
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).
12 1 bmbouter
13
## Recording a Video
14
15 10 mcorr
Although audio is welcome, it is not a requirement. 
16 1 bmbouter
17 10 mcorr
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. 
18
19
Whatever you use, ensure that you:
20
21 1 bmbouter
1\. Increase the font! Whatever you think is readable, make it a lot bigger.  
22 10 mcorr
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.
23 1 bmbouter
24 10 mcorr
## asciinema
25
26
You can also use [asciinema](https://asciinema.org/) to record your demo. 
27
28
When using asciinema, it's important to set your terminal size so that the video output for all demos is consistent. 
29
Before you begin your demo, please set your terminal size to 90x45 characters. 
30
In order to automate and properly anonymise asciinema generation, you can add it to the [saftladen](https://github.com/mdellweg/saftladen) repository.
31
The asciicasts generated there can be uploaded to [asciinema](https://asciinema.org/) to be embedded in any kind of web content.
32
33 4 bmbouter
## Testing your Video
34
35 8 bmbouter
All video playback happens in Firefox. Ensure that a normal Firefox browser can natively play your video.
36 9 mdellweg
37 11 mcorr
## Sharing your Video
38 9 mdellweg
39 11 mcorr
1\. Add a link to your video in the body of the pull request that you're submitting. 
40 12 mcorr
41 11 mcorr
2\. Tag [@melcorr](https://github.com/melcorr) in the body of the pull request so she can add your demo to a latest demo list on the Pulp website.