Improve documentation of data format of dependency inputs

[arduino]

Improve documentation of data format of dependency inputs

[per1234]

Hi @faultfactory. Thanks for your report. Each of the elements of the platforms input list is a separate platform definition object. These objects consist of the keys mentioned in the documentation.

Your code here:

platforms:  |
  - name: "adafruit:samd"
  - source-url: "https://adafruit.github.io/arduino-board-index/package_adafruit_index.json"

contains two separate platform definition objects, one for each of the elements of the list. So you have specified that a platform with the ID adafruit:samd should be installed, then you have specified that different platform with Boards Manager package index https://adafruit.github.io/arduino-board-index/package_adafruit_index.json should be installed.

But what you were intended to do was specify a single platform. To do that, all keys must be in the same element, like this:

platforms:  |
  - name: "adafruit:samd"
    source-url: "https://adafruit.github.io/arduino-board-index/package_adafruit_index.json"

So the documentation is correct, and the action works just as documented. However, I think this indicates it is not as clear as it should be. We can use this issue to track the need to improve on that.

Probably the most helpful thing would be to provide a dedicated example snippet for each of the source type sections under the platforms input documentation (currently there is only at the top level section of that documentation).

I think the wording could also be improved to be more clear.

If anyone wants to submit pull requests proposing improvements to the documentation, I would be happy to review them.

appended the URL to the fqbn field

The code that allows that was added to provided backwards compatibility for workflows using the poorly designed API of the earliest alpha version of the action. It is deprecated and might be removed at any time. Use of that API is strongly discouraged.