Skip to content
This repository was archived by the owner on Mar 17, 2025. It is now read-only.

Add javadocs to Arduino API. #123

Merged
merged 6 commits into from
May 11, 2016
Merged

Conversation

ed7coyne
Copy link
Collaborator

@ed7coyne ed7coyne commented May 6, 2016

Follows the style layed out here: http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html

There are several options. I chose the javadoc style but am not particularly attached to it.

@ed7coyne
Copy link
Collaborator Author

ed7coyne commented May 6, 2016

First step towards #30

@@ -24,18 +24,97 @@
#define FIREBASE_JSONBUFFER_SIZE 200
#endif // FIREBASE_JSONBUFFER_SIZE

/**
* Gateway class for Arduino clients to interact with the Firebase backend.
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe we should also precise there is the default Firebase instance and give an example.

s/Gateway/Main/

s/the Firebase backend/Firebase/

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

@proppy
Copy link
Contributor

proppy commented May 7, 2016

LGTM, just nits.

class FirebaseArduino {
public:
/**
* Must be called first. This sets the class up for use.
Copy link
Contributor

Choose a reason for hiding this comment

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

s/This sets the class up for use/This initialize the client with the given firebase host and credentials.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

@ed7coyne ed7coyne merged commit e326b43 into FirebaseExtended:master May 11, 2016
@ed7coyne ed7coyne deleted the add-docs branch June 17, 2016 16:33
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants