add docstring for each method on FirebaseArduino and generate documentation

[proppy]

Possible tooling options:
https://github.com/tripit/slate
http://www.stack.nl/~dimitri/doxygen/
https://jashkenas.github.io/docco/
https://github.com/circuitar/ArduinoDocs

[ed7coyne]

Best I can determine slate, while it looks awesome, does not actually do docstrings and is basically just a way to write a nice looking website using markdown.

docco seems to be setup to do that but I am having trouble finding a compelling example of it's output.

I think the industry standard doxygen, possibly with ArduinoDocs is the way to go.

I am going to start adding the documentation to the code in the JavaDoc format and we can go from there.

[ed7coyne]

Since this is for the workshop I assume we only want this on the top-most api for now (FirebaseArduino) this is done.