Merge branch 'master' of https://github.com/arduino/arduino-cli

Author: vinay-lanka

.github/workflows/docs.yaml

@@ -0,0 +1,80 @@
+name: docs
+
+on:
+  pull_request:
+    paths:
+      # existing docs
+      - 'docs/**'
+      # changes to the cli reference generator
+      - 'docsgen/**'
+      # potential changes to commands documentation
+      - 'cli/**'
+      # potential changes to gRPC documentation
+      - 'rpc/**'
+  push:
+    branches:
+      - master
+    # At this day, GitHub doesn't support YAML anchors, d'oh!
+    paths:
+      - 'docs/**'
+      - 'docsgen/**'
+      - 'cli/**'
+      - 'rpc/**'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Install Taskfile
+        uses: Arduino/actions/setup-taskfile@master
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Go
+        uses: actions/setup-go@v2-beta
+        with:
+          go-version: '1.14'
+
+      - name: Install Go dependencies
+        run: |
+          go version
+          go get -u github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc
+
+      - name: Install protoc compiler
+        uses: arduino/[email protected]
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Python
+        uses: actions/setup-python@v1
+        with:
+          python-version: '3.6'
+          architecture: 'x64'
+
+      - name: Cache dependencies
+        uses: actions/cache@v1
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install Python dependencies
+        run: |
+          python3 -m pip install --upgrade pip
+          python3 -m pip install -r ./requirements_docs.txt
+
+      - name: Build docs website
+        run: task docs:build
+
+      - name: Deploy
+        # publish docs only when PR is merged on master
+        if: github.event_name == 'push'
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./public

.github/workflows/test.yaml

@@ -25,7 +25,7 @@ jobs:
       - name: Install Go
         uses: actions/setup-go@v1
         with:
-          go-version: '1.13'
+          go-version: '1.14'
 
       - name: Install Go deps
         # Since 10/23/2019 pwsh is the default shell

.gitignore

@@ -20,3 +20,9 @@ venv
 
 # Misc.
 .DS_Store
+
+# Mkdocs
+/public/
+/docsgen/arduino-cli
+/docs/rpc/*.md
+/docs/commands/*.md

Dockerfiles/builder/Dockerfile

@@ -5,7 +5,7 @@ ENV PATH $PATH:/usr/local/go/bin
 # Install tooling
 ENV GORELEASER_VER 0.113.0
 ENV GORELEASER_SHA 2379beebb6369b75ccead7f7a43269de700b51821feae3857701d106ed72bd63
-ENV GOVER 1.13
+ENV GOVER 1.14
 RUN set -ex \
     && curl -o goreleaser.tar.gz -LO https://github.com/goreleaser/goreleaser/releases/download/v${GORELEASER_VER}/goreleaser_Linux_x86_64.tar.gz \
     && echo "$GORELEASER_SHA goreleaser.tar.gz" | sha256sum -c - || exit 1 \

README.md

@@ -0,0 +1,48 @@
+# arduino-cli
+
+![cli-logo](./docs/img/featured-CLI.png)
+
+Arduino CLI is an all-in-one solution that provides builder, boards/library manager,
+uploader, discovery and many other tools needed to use any Arduino compatible
+board and platforms.
+
+[![tests-badge]](https://github.com/Arduino/arduino-cli/actions?workflow=test)
+[![nightly-badge]](https://github.com/Arduino/arduino-cli/actions?workflow=nightly)
+[![docs-badge]](https://github.com/Arduino/arduino-cli/actions?workflow=docs)
+[![codecov-badge]](https://codecov.io/gh/arduino/arduino-cli)
+
+> **Note:** this software is currently under active development: anything can change
+  at any time, API and UI must be considered unstable until we release version 1.0.0.
+
+## Docs
+
+For guidance on installation and development, see the [User documentation].
+
+## Quickstart
+
+1. [Install] the Arduino CLI
+2. Follow the [Getting Started] guide to check out what the CLI can do
+3. Browse the [Commands reference] to see all the available commands
+4. Should you have an issue, read the [FAQ] page
+
+## How to contribute
+
+Contributions are welcome!
+
+Please read the document [How to contribute] which will show you how to build
+the source code, run the tests, and contribute your changes to the project.
+
+:sparkles: Thanks to all our [contributors]! :sparkles:
+
+
+[tests-badge]: https://github.com/Arduino/arduino-cli/workflows/test/badge.svg
+[nightly-badge]: https://github.com/Arduino/arduino-cli/workflows/nightly/badge.svg
+[docs-badge]: https://github.com/Arduino/arduino-cli/workflows/docs/badge.svg
+[codecov-badge]: https://codecov.io/gh/arduino/arduino-cli/branch/master/graph/badge.svg
+[Install]: https://arduino.github.io/arduino-cli/installation
+[User documentation]: https://arduino.github.io/arduino-cli/
+[Getting Started]: https://arduino.github.io/arduino-cli/getting-started/
+[Commands reference]: https://arduino.github.io/arduino-cli/commands/arduino-cli
+[FAQ]: https://arduino.github.io/arduino-cli/FAQ/
+[How to contribute]: https://arduino.github.io/arduino-cli/CONTRIBUTING/
+[contributors]: https://github.com/arduino/arduino-cli/graphs/contributors