Skip to content

Conversation

@dido18
Copy link
Contributor

@dido18 dido18 commented Nov 10, 2025

Motivation

Going open source, we need a better issue-reporting mechanism and better documentation.

Change description

  • Edit the README with more concise information
  • Created a docs folder with
    • Contributing.md guide
    • contribute-guide with the markdown guide
    • user-documentation.md with an initial documentation of the arduino-app-cli
  • Creates a ISSUE_TEMPLATE folder with two types of issues "Bug report" or "Feature request"
  • Renamed arduino-app-cli:build:local: into buld and arduino-app-cli:start into start

Additional Notes

Taken from https://github.com/arduino/tooling-project-assets/
beta-testing has not been added

Reviewer checklist

  • PR addresses a single concern.
  • PR title and description are properly filled.
  • Changes will be merged in main.
  • Changes are covered by tests.
  • Logging is meaningful in case of troubleshooting.

@per1234 per1234 added documentation Improvements or additions to documentation enhancement New feature or request labels Nov 10, 2025
@dido18 dido18 changed the title docs: Add readme with CONTRIBUTING.md guidelines docs: refactor readme + guidelines Nov 11, 2025
@dido18 dido18 marked this pull request as ready for review November 11, 2025 14:05
@dido18 dido18 requested a review from a team November 11, 2025 14:21
Copy link
Contributor

@lucarin91 lucarin91 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dido18 can you rebase with the latest main?

dido18 and others added 21 commits November 13, 2025 10:54
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
Co-authored-by: Per Tillisch <accounts@perglass.com>
@dido18 dido18 force-pushed the add-readme-contributing branch from 2d62074 to 6983bf9 Compare November 13, 2025 09:55
@dido18 dido18 requested review from lucarin91 and per1234 November 17, 2025 10:59
@dido18 dido18 requested a review from per1234 November 17, 2025 14:56

- `go tool task init`
- `go tool task build`
- `go tool task generate:assets` to download locally the assets of the [Arduino Bricks](`https://github.com/arduino/app-bricks-py`)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `go tool task generate:assets` to download locally the assets of the [Arduino Bricks](`https://github.com/arduino/app-bricks-py`)
- `go tool task generate:assets` to download locally the assets of the [Arduino Bricks](https://github.com/arduino/app-bricks-py)

Fix link markup.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants