* fetch available languages from transifex

* fix documentation on i18n update

* add documentation on contributing for i18n workflow

…737)

This commits excludes:

- generated files
- i18n tooling for generating translations files that are not used in
  the final build of the cli.

suceed -> succeed
documentaiton -> documentation
saerching -> searching
plattform -> platform

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* [skip changelog] document the docs generation workflow

* clarify how humans should not push to gh-pages

* Apply suggestions from code review

Co-authored-by: per1234 <accounts@perglass.com>

Co-authored-by: per1234 <accounts@perglass.com>

)

Arduino CLI provides three interfaces for integration:
- command line
- gRPC
- Go library

This is an article written by Massimiliano Pippi, which I have merely converted to Markdown and added some links to.

…levant to Arduino CLI (#732)

This section of the documentation was written with a focus on the Arduino IDE, and thus was not very friendly to Arduino CLI users.

The portable condition was wrong (it checked for 'non-existance' instead
of 'existance').

I've replaced all the conditions with the more readable path.Exist
method.

…at (#744)

* Fixed skethbook+bootloader hex merger.

Previous merger doesn't take into account .bin bootloaders and it may
have problems if .hex data is not sorted by address.

* output a merged sketch+bootloader bin file too

* Replace logger with utils.LogIfVerbose

Co-authored-by: Martino Facchin <m.facchin@arduino.cc>

This removes the --relax option, potentially producing slightly bigger code for the atmega2560. On the longer term, the AVR core should just add this option for all boards, but this is not currently the case yet because removing --relax also works around a gcc miscompilation (see arduino/ArduinoCore-avr#339).

Close: #639

* add basic implementation of bash completion

* update cobra to 1.0.0 because of spf13/cobra#1048

* add support for zsh and fish, improved help messages

* add flag ´--no-descriptions´ to disable automatic command description (for shells that supports it)

* fix fish not supporting env variables with dash in the name

* fixed zsh completion not working

* revert "#compdef" patch

* add check on --no-description flag
add comments regarding "hacks"
change Replacer with ReplaceAll (for readability)

* add docs

* Apply suggestions from code review

fix typos and corrections

Co-authored-by: per1234 <accounts@perglass.com>

* forgot a space

* fix fish docs

* add test for completion

Co-authored-by: per1234 <accounts@perglass.com>

* Added scaffolding for external programmer support

* Added programmers extraction in arduino/cores module

* Implemented programmers list command

* Print upload command line in verbose mode

* Added programmer option to compile command

* External programmer implementation

* Factored function runTool in upload

This will turn out useful for burn-bootloader that requires to run
two actions in a row ("erase" and "bootloader").

* Implemented burn-bootloader

* Increased tracing log

* Test fix

* Added BurnBootloder action

* Make the upload port parameter mandatory only when really needed

* Fixed nil pointer exception when burning-bootloader

* Added sanity check on upload parameters

… interface (#692)

* [skip changelog] Add documentation for library components of the gRPC interface

Comments added to the .proto files are included in the generated gRPC interface documentation.

* Correct documentation re: relative vs absolute paths provided by Library message fields

Co-authored-by: Roberto Sora <r.sora@arduino.cc>

* Use preferred "platform" term in gRPC interface documentation

The official term is now "platform", rather than the previous ambiguous "core".

Co-authored-by: Roberto Sora <r.sora@arduino.cc>

* Fix formatting of gRPC interface documentation

* Fix incorrect documentation for task_progress field of LibraryUninstall response

* Document that library version is the key of the releases map

* Update gRPC interface code comments

Co-authored-by: Roberto Sora <r.sora@arduino.cc>

The ability to configure Arduino CLI via environment variables is only documented by a mention in the integration options article, which is not an obvious place to look for that information. Since this information didn't fit well in any of the existing pages, it makes sense to add a dedicated page, and add some documentation for the other two configuration methods as well. Although there is existing documentation for the other configuration methods elsewhere in the docs, it is missing some useful specifics, which wouldn't be appropriate to add there.