"Select board and port in Arduino IDE" – improved and updated for 2.0.0

[seaxwi]

Updated for 2.0.0

Internal key: HC-1115

[Renat0Ribeir0]

Added one comment. LGTM otherwise 👍

[per1234]

The label "BOARD CORE" is incorrect on this image:

content/Software Support/Upload/img/board-selector-labels.png

This is the board name, not the core.

[seaxwi]

@per1234 I see now that "board core" is inaccurate. I have commited your suggestions and will update the image.

I was trying to clarify that "board" here doesn't refer to a physical device. In the platform specification for boards.txt we have

"This file contains definitions and metadata for the boards supported by the platform"

and

"An extract of the Uno board configuration in boards.txt"

Would you say that "configuration" is a good word to describe what the board selection in Arduino IDE is?

[per1234]

Would you say that "configuration" is a good word to describe what the board selection in Arduino IDE is?

I would say that use of that term in a context like the following is reasonable:

Selecting Tools > Board > Arduino AVR Boards > Arduino Uno and the port from Tools > Port in the Arduino IDE menus configures the Arduino IDE to compile and upload the sketch to your Arduino board.

But I do not think it is a good word in a context like this:

Select the board configuration for your Uno from the Tools > Board menu in the Arduino IDE.

"Configuration" adds unnecessary complexity. Although it is important for a boards platform author to understand how a board is defined in boards.txt, it is not at all for the user. All they need and want to know is that they must make the correct board selection from the menu.

I was trying to clarify that "board" here doesn't refer to a physical device.

This is wise. I think the overloading of terminology can be quite confusing to beginners. However, I don't think it is a problem when you are explicitly instructing the user to select something from a menu. In cases where the menu selection is referred to in general, I would use the term "board selection". In these cases, I would reserve the term "board" (or "Arduino board") alone for referring to the hardware.