OC-Client setup documentation

[nickbalestra]

Improve documentation related to adding the oc-client.js library via the oc-client componnet.
@kmcrawford had some issue understanding the workflow and how to configure that scenario, feel free to add some extra context on what wasn't clear so that we can improve the documentation on that.

[elboletaire]

All the documentation of the project is stored in the github wiki? I think we should do something about that too.

[nickbalestra]

Yes, what would you suggest?

[elboletaire]

I think github wikis never worked too well, everyone usually moves to use something like gh-pages (with a custom static built page), or services like readthedocs.io. In fact, we could even use both. Use gh-pages for the pretty version publishing the product and the documentation in readthedocs.io.

Or even having everything in gh-pages well packaged (both the "product page" + the documentation)... I don't know, are just ideas.

[jackbush-rl]

@nickbalestra hi there :) we're looking at using OC for a large project at rocket lawyer (and loving bits of it!), but the lack of documentation is a significant hurdle to adoption -- is there a plan for more detailed documentation?