expounded docs and removed all list references