Skip to content
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

Adding advance example and documentation #3

Merged
merged 13 commits into from
Aug 21, 2020

Conversation

sanujkul
Copy link
Contributor

@sanujkul sanujkul commented Mar 7, 2020

Adding an advance example that can make use of software serial as old Arduino boards only have one Serial and thus using your library with SoftwareSerial output Stream will give lots of flexibility.

Adding documentation as it will help the users to know how to use this library and what all ways are there.

@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: 7a7b5c50-6070-11ea-afc8-ddb27bdee665

@sanujkul
Copy link
Contributor Author

sanujkul commented Mar 7, 2020

Can someone please help me in understanding why I have failed this check and what has to be done?
I have only added an example and edited Readme.md.

@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: b14261b0-6071-11ea-afc8-ddb27bdee665

@per1234
Copy link
Contributor

per1234 commented Mar 7, 2020

Can someone please help me in understanding why I have failed this check

The check is for a specific formatting standard, which your code doesn't match.

what has to be done?

In this case, you can resolve the problem by doing a Tools > Auto Format on /examples/Arduino_Debug_Advance/Arduino_Debug_Advance.ino if using the Arduino IDE or pressing Ctrl + b if using the Arduino Web Editor.

I know it's confusing that the Arduino IDE automatically adds these * to multi-line comments, then the auto format takes them away (arduino/Arduino#3941), but we used the auto format style in our formatting standard.

per1234
per1234 previously requested changes Mar 7, 2020
Copy link
Contributor

@per1234 per1234 left a comment

Choose a reason for hiding this comment

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

Your numbering goes:
1.
2.
2.
3.

I don't see any benefit to having these numbers. As we can see here, they make the documentation more difficult to maintain. So I suggest just removing them.


You established a convention of documenting the return type in the Debug.setDebugLevel(int const debug_level) documentation, then abandoned that convention in the rest of the documentation. I think it is good to document return types, so I would suggest you add this documentation to the rest.

sanujkul and others added 4 commits March 8, 2020 14:25
Co-Authored-By: per1234 <accounts@perglass.com>
Co-Authored-By: per1234 <accounts@perglass.com>
Co-Authored-By: per1234 <accounts@perglass.com>
Co-Authored-By: per1234 <accounts@perglass.com>
@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: de0169e0-611a-11ea-b333-4fa8171c3056

sanujkul and others added 2 commits March 8, 2020 14:27
Correcting spelling of Arduino in comments

Co-Authored-By: per1234 <accounts@perglass.com>
Co-Authored-By: per1234 <accounts@perglass.com>
@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: 02e33f40-611b-11ea-b333-4fa8171c3056

@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: 22d90280-611b-11ea-b333-4fa8171c3056

sanujkul and others added 2 commits March 8, 2020 14:29
Adding a linebreak

Co-Authored-By: per1234 <accounts@perglass.com>
Adding one more linebreak

Co-Authored-By: per1234 <accounts@perglass.com>
@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: 477b36d0-611b-11ea-b333-4fa8171c3056

@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: 6c085c80-611b-11ea-b333-4fa8171c3056

@TravisBuddy
Copy link

Travis tests have failed

Hey @sanujkul,
Please read the following log in order to understand the failure reason.
It'll be awesome if you fix what's wrong and commit the changes.

TravisBuddy Request Identifier: f5186790-611b-11ea-b333-4fa8171c3056

@sanujkul
Copy link
Contributor Author

sanujkul commented Mar 8, 2020

@per1234 . Thank you! I have committed your suggestions and also modified Readme.md to remove numbering and added Return type and Example to all member functions. But still it is failing travis test!

@sanujkul
Copy link
Contributor Author

sanujkul commented Mar 8, 2020

@per1234 . Thank you very much for your suggestions. I did auto-formatting and it worked! :)

@sanujkul sanujkul requested a review from per1234 March 8, 2020 09:25
@per1234 per1234 dismissed their stale review March 14, 2020 10:29

Requested changes have been made. Thanks!

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 @sanujkul 👋

@aentinger aentinger merged commit fc5ec94 into arduino-libraries:master Aug 21, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants