Documentation about client code

It describes:
- project structure
- authorizations

Please note that the new document is written in markdown because I did not know how to present source tree or how to highlight javascript snippet. Also I'm nto even sure that the JS snippet will be correctly highlighted on github as locally it did not work with Jekyll.