Skip to content

Improve documentation #4

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 6 commits into from
Sep 15, 2020
Merged

Improve documentation #4

merged 6 commits into from
Sep 15, 2020

Conversation

per1234
Copy link
Collaborator

@per1234 per1234 commented Sep 11, 2020

  • Add badges to readme to indicate CI status
  • Correct branch name shown in example snippet in readme
  • Format the documentation to make default input values easy to find
  • Improve formatting of readme
  • Linkify readme text where appropriate to provide easy access to supporting information

Unlike the original repository, this repository uses a default branch named `main` instead of `master`.
Previously, the information on whether an input had a default value -- and if so, what -- was incorporated into the input description.
This meant you had to read the entire description to find this information.

When using other actions, I have regularly had difficulty determining which inputs are required and default input values.
I would like for the users of this action to not have that experience.
@per1234 per1234 added type: imperfection Perceived defect in any part of project topic: documentation Related to documentation for the project type: enhancement Proposed improvement labels Sep 11, 2020
…artifact to readme

Adding the example workflow to generate the workflow artifact to the arduino/report-size-deltas readme allows the arduino/compile-sketches readme to only demonstrate the basic use of the action without confusing the issue by showing the creation of a workflow artifact that will only be of use to arduino/report-size-deltas users.
Copy link
Contributor

@aentinger aentinger left a comment

Choose a reason for hiding this comment

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

LGTM 👍 Thank you @per1234 🚀

@aentinger aentinger merged commit 66f2d53 into arduino:main Sep 15, 2020
@per1234 per1234 deleted the fix-docs branch September 15, 2020 12:22
@per1234 per1234 self-assigned this Jun 13, 2024
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 type: enhancement Proposed improvement type: imperfection Perceived defect in any part of project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants