Guidelines for videos and tutorials

A place to share learning material: written tutorials, videos, etc.
chrisb
Posts: 20758
Joined: Tue Mar 17, 2015 9:14 am

Guidelines for videos and tutorials

Postby chrisb » Wed May 08, 2019 7:16 am

I would like to create a sticky topic in this subforum with some guidelines. Please add (and discuss) further proposals for some general rules, which can be compiled in such a topic.

My first suggestion is
  • Mention the FreeCAD version used

    Every tutorial should start with clearly stating for which version it was made. Video tutorials should state it in the description or at least within the first 15 seconds.
User avatar
sgrogan
Posts: 5547
Joined: Wed Oct 22, 2014 5:02 pm

Re: Guidelines for videos and tutorials

Postby sgrogan » Wed May 08, 2019 9:46 pm

Videos should never auto-start.
After starting there should be a way to quit/pause.
User avatar
wandererfan
Posts: 3363
Joined: Tue Nov 06, 2012 5:42 pm

Re: Guidelines for videos and tutorials

Postby wandererfan » Sun Jun 09, 2019 1:39 pm

User avatar
Celica_Supra
Posts: 43
Joined: Sat Nov 03, 2018 11:18 pm
Contact:

Re: Guidelines for videos and tutorials

Postby Celica_Supra » Wed Jul 31, 2019 8:05 am

I would suggest calling out all hotkeys used, at least the first few times if they are used multiple times.
kisolre
Posts: 1363
Joined: Wed Nov 21, 2018 1:13 pm

Re: Guidelines for videos and tutorials

Postby kisolre » Wed Jul 31, 2019 9:57 am

Briefly describe expected level of FreeCAD understanding at the begining. If for example tutorial is for FEM user should know how to model the solid to be analyzed.
User avatar
PrzemoF
Posts: 2660
Joined: Fri Jul 25, 2014 4:52 pm
Contact:

Re: Guidelines for videos and tutorials

Postby PrzemoF » Wed Jul 31, 2019 10:15 am

Celica_Supra wrote:
Wed Jul 31, 2019 8:05 am
I would suggest calling out all hotkeys used, at least the first few times if they are used multiple times.
key-mon [1] or other tool showing keys/mouse buttons pressed are really handy for that.

[1] https://code.google.com/archive/p/key-mon/
User avatar
Celica_Supra
Posts: 43
Joined: Sat Nov 03, 2018 11:18 pm
Contact:

Re: Guidelines for videos and tutorials

Postby Celica_Supra » Wed Jul 31, 2019 4:40 pm

PrzemoF wrote:
Wed Jul 31, 2019 10:15 am
Celica_Supra wrote:
Wed Jul 31, 2019 8:05 am
I would suggest calling out all hotkeys used, at least the first few times if they are used multiple times.
key-mon [1] or other tool showing keys/mouse buttons pressed are really handy for that.

[1] https://code.google.com/archive/p/key-mon/
That looks like a fantastic tool- I think we all have had that experience when the tutorial doesn't call out a hotkey and all of a sudden you're stuck!
freecad-heini-1
Posts: 6257
Joined: Tue Jan 07, 2014 11:10 am
Contact:

Re: Guidelines for videos and tutorials

Postby freecad-heini-1 » Mon Nov 25, 2019 4:26 pm

For all Linux users, do you already know Screenkey?
Very helpful for tutorials.
http://www.thregr.org/~wavexx/software/screenkey/
dxp.dev
Posts: 133
Joined: Tue Dec 11, 2018 12:57 pm

Re: Guidelines for videos and tutorials

Postby dxp.dev » Sun Dec 08, 2019 2:37 pm

On Mac you have keyCastr
https://github.com/keycastr/keycastr
Imperial system makes no sense, go metric ! ! !