Have visible explanations with functions

[lemio]

As in the discussion around the abs function, I think it could benefit the whole Arduino ecosystem to have explanations in animation format (explorable would be even better). This could put functions in context and could help non-readers, or people that don't understand the physical programming jargon to still make sense of what functions are doing.

In the best-case scenario, the images/animations don't have written text except for the functions/code.

Below is one example to trigger the discussion; I think for teachers and beginners this could be a great asset to explain or understand what certain functions are doing. In an optimal scenario, we could make something like choc where we could simulate Arduino behaviour and drag through time.

In a less optimal scenario, we make some standard for making graphics; that can than be used throughout the reference...

I fully agree with @robsoncouto about the issue of consistency

I think that uniformity may be a problem, so if images are to be used, there should be guidelines on how to create them, like the size, colors, etc. Also, If the images contain text, they may not be easily reused in the other translated references without editing.

I'm curious what you're thinking

[lemio]

Hey,

I'm finishing of my thesis on making tools like Arduino more collaborative and fluid; if you want to check out the video it's here: https://vimeo.com/424519195 But using this tool it's also possible to create material that could be potentially interesting for the reference; it gives an overview of the context; the use of a function; the output (range) of a function. Without describing it; but just by showing it...

I'm curious about any thoughts on this, these little videos are quite easy to make...