Add automatic documentation via GitHub Pages

[srounce]

🎅🎄🎁☃️👼❄️🌟

Pretty self-explanatory really.

What it does

1. Commits go into master
2. Doxygen gets run in Travis CI environment and generates cpp_utils documentation
3. HTML gets published to https://nkolban.github.io/esp32-snippets.

Todo:

Before merging the following will have to be done by someone with the required access level to this repository:

• Setup Travis CI account (free for OSS)
• Generate token and add to CI variables as per instructions
• Have a very Merry Christmas 🥂

[srounce]

@nkolban @chegewara

Any chance of getting some feedback on this?

[chegewara]

Hi @srounce
As you mentioned there is few thing TODO before merging this. I have no idea how much time it require to setup it but we both are busy now, but when i find some time i will try to prepare it.
It is good idea to have it done, but it also require to review whole code and add necessary documentation comments where they are missing.

[maxbachmann]

@chegewara I do not really see the problem.
The ToDo is

• Setup Travis which is actually create a account and activate it for the repository
• create a token in the github developer settings and add it to travis as a secret variable called GITHUB_TOKEN
• activate github pages for the repository
• sure more comments for everything would be nice, but thats the case wether it´s on github pages or not. And when the documentation get´s improved over time the documentation on github pages will aswell, so thats not really a problem

[chegewara]

• create a token in the github developer settings and add it to travis as a secret variable called GITHUB_TOKEN

Thats the point, i dont have access to repository settings.

[maxbachmann]

Yeah thats a valid point ;) (only @nkolban has access?)

[srounce]

@maxbachmann It could probably do with a bit of prettying up. My fork currently has it set up and is visible here: https://srounce.github.io/esp32-snippets
If you would like to help make them look nice and engaging for users/readers then you're more than welcome to add some commits to my branch.

[maxbachmann]

I will definetly look into it

[madsdyd]

@chegewara Maybe we could petition @nkolban to give you access to change the repository settings? It would be really great to have docs automatically created.

[srounce]

I'd love to get this branch merged if possible.