clarified server responsibilities in docs intro

Closes #162
clarified entities and discovery in docs intro

Closes #161