[Doc-SIG] Video content in the standard library documentation

[Al Sweigart]

I definitely agree will all of Julien's points. Having a face is
distracting, makes editing harder, and dealing with lighting/makeup to look
good on camera is a pain.

Also, the videos should be a *maximum* of 6 minutes in length. Philip Guo
(creator of pythontutor.com and a CS professor at Rochester) has a great
article on engagement rates for online course videos. Even with the
concerns about engagement aside, short videos are easier to make and keep
up to date.

Something else to consider: Do we need videos? We could also consider using
a webpage with one of those https://trinket.io/ in-browser interactive
shells (though the PSF probably doesn't want to play favorites with any
company.)

-Al

On Sun, May 6, 2018 at 1:25 AM, Julien Palard via Doc-SIG <
doc-sig at python.org> wrote:

> > I was thinking of providing a set of templates and guidelines for having
> “5 minute overview” videos
>
> I propose this guideline:
>
> - Never show the face of someone speaking.
>
> Why? It allows to:
>
> - FIX a section of the sound track without re-recording the video track
> (in case of a error, or to better phrase something).
> - Translate the audio tracks of the videos without caring about lip sync
> (I suspect non of us are willing to do lip sync).
>
> Why fixing is important?
>
> I know one (but won't public-shame) of a really great Python video, really
> high video, studio, setup quality, video editing, ... all good, but we
> *see* the speaker state something wrong about Python! Looks like they can't
> fix it (setting up the studio with the same decoration is undoable). Yes
> they could, should probably remove the section though.
>
> Looks like Al Sweigart got this guideline right in its scratch series if
> we want a good example.
>
> Best,
> ​--
> Julien Palard
> https://mdk.fr​
>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> https://mail.python.org/mailman/listinfo/doc-sig
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/doc-sig/attachments/20180506/49c3186c/attachment.html>