Skip to content

[skip changelog] Document sketch filename requirements #1287

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 12, 2021
Merged

[skip changelog] Document sketch filename requirements #1287

merged 1 commit into from
May 12, 2021

Conversation

per1234
Copy link
Contributor

@per1234 per1234 commented May 12, 2021

Please check if the PR fulfills these requirements

  • The PR has no duplicates (please search among the Pull Requests
    before creating one)
  • The PR follows
    our contributing guidelines
  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been added / updated (for bug fixes / features)
  • UPGRADING.md has been updated with a migration guide (for breaking changes)
  • What kind of change does this PR introduce?

docs update

  • What is the current behavior?

The Arduino Sketch Specification only documents the requirements for sketch folder names. Since the primary sketch filename must match the folder name, this appears at a glance to be self-evident. However, sketches may consist of multiple code files, and so the specification was ambiguous regarding the naming requirements for additional files.

  • What is the new behavior?

The specification documents that the same naming requirements apply to all sketch code files.

No breaking change.

  • Other information:

Related: #1194


See how to contribute

Previously, the Arduino Sketch Specification only documented the requirements for sketch folder names. Since the primary
sketch filename must match the folder name, this appeared at a glance to be self-evident. However, sketches may consist
of multiple files, and so the specification was ambiguous regarding the naming requirements for additional files.
@per1234 per1234 added type: bug topic: documentation Related to documentation for the project labels May 12, 2021
@per1234 per1234 requested review from silvanocerza and umbynos May 12, 2021 15:11
@per1234 per1234 merged commit da658ab into arduino:master May 12, 2021
@per1234 per1234 deleted the sketch-filename-specification branch May 12, 2021 16:11
@per1234 per1234 self-assigned this Nov 23, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
topic: documentation Related to documentation for the project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants