update some parts of documetation to use actual state of a player + more info on embedding
Merge remote-tracking branch 'origin/master'