[cleanup] improved README

see it in action at https://github.com/tkrille/osiam-server/blob/readme/README.md.