Skip to content

Have visible explanations with functions #724

Open
@lemio

Description

@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...

code_explained_best (1)

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions