Add state description to membership docs

Closes #371
Merge pull request #379 from edpaget/update-membership-docs

Add state description to membership docs