Skip to content

Conversation

umbynos
Copy link
Contributor

@umbynos umbynos commented Feb 8, 2019

I started improving README.md upon request of @mattiabertorello. I will include a basic explanation of the Arduino IoT Cloud, and then an explanation of most important functions in the library. Would that be ok?

@umbynos umbynos self-assigned this Feb 8, 2019
@umbynos umbynos requested a review from ubidefeo February 8, 2019 10:59
@umbynos umbynos changed the title [WIP] Improving README.md Improving README.md Feb 14, 2019
README.md Outdated

- `disconnect()` stops the MQTT Client

- The `update()` function checks the connnection with the MQTT broker, retrieve data from it and pushes back data using `writeProperties()`. `update()` is called periodically in the loop of .ino file.

Choose a reason for hiding this comment

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

@umbynos I'd change the last sentence with something like "update() SHOULD BE called periodically in the loop() function."

README.md Outdated

- The `update()` function checks the connnection with the MQTT broker, retrieve data from it and pushes back data using `writeProperties()`. `update()` is called periodically in the loop of .ino file.

- `connected()` simply returns the current status of the MQTT connection.
Copy link

@AlbyIanna AlbyIanna Feb 14, 2019

Choose a reason for hiding this comment

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

@umbynos is this function returning just true or false or are there more statuses? I think we should write exactly what it's returning

README.md Outdated

- `reconnect(Client&)` clean up existing MQTT connection, create a new one and initialize it by calling `connect()`

- `writeProperties(const byte data[], int length)` writes message to the MQTT Broker

Choose a reason for hiding this comment

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

@umbynos can this definition be more specific?

@ubidefeo
Copy link
Collaborator

folks, I think this can be merged in
any doubts?

@per1234
Copy link
Contributor

per1234 commented Feb 20, 2019

@ubidefeo I did another review of the updated text and requested some changes. Hopefully umbynos can take a minute to consider these suggestions before this is merged. Thanks for taking action on my previous suggestions!

Co-Authored-By: umbynos <34278123+umbynos@users.noreply.github.com>
Copy link
Collaborator

@ubidefeo ubidefeo left a comment

Choose a reason for hiding this comment

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

looks good
merging

@ubidefeo ubidefeo merged commit 79e7aa5 into master Feb 20, 2019
@mattiabertorello mattiabertorello deleted the update_readme branch May 13, 2019 15:09
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