Descriptive mouseOver messages

[lemio]

Is your feature request related to a problem? Please describe.
Since the Arduino ecosystem is made to get people with a limited background of programming or electronics into this field, it would be interesting to consider giving a very short description and link to the reference when hovering over the elements.

Right now it shows the bare minimum on information (not the name of the arguments, datatypes in cpp instead of the more readable Arduino way)

Describe the solution you'd like

This is a small attempt to make a description that might be understandable by a beginner, that could be included in the header files, with a hyperlink to the reference and a nicer way to describe the function. *int should be boolean

Describe alternatives you've considered
It might be that this function is only enabled in the limited version of the interface; the non-advanced version; but if we could make it a standard to have a short description in the header files; it might actually make life easier for the reader of the header files and the beginning user trying to make sense of a piece of code.

Additional context
This screenshot above is just an example of the concept; the text; color coding; could probably be improved.

These look more like the function itself since it is called digitalWrite:

Write a value to a pin

Write a digital value to a pin

These don't look like the function itself, which could be confusing or enlighting (having different words to describe the same) and the order of the words matches the function's arguments:

Give a pin a digital value

Give a physical pin a digital value

[per1234]

link to the reference

There is a similar functionality in the classic Arduino IDE. The way it works is when a reference page name is defined in a keywords.txt file:
https://arduino.github.io/arduino-cli/latest/library-specification/#reference_link
then when you do a Right Click > Find in Reference or Help > Find in Reference while the cursor is on that keyword the reference page is opened in the browser.