Write a proper readme explaining inner works and usage of comment service

[timberhill]

Acceptance criteria:

There is a document detailing how the service is built, like tools, logic and protocols
The team goes through it in person to review

Moved from flam-flam/.github-private#9