document the particle statistics interface (for bosonic and fermionic and other states)

[Krastanov]

#160 introduced a principled way to deal with multi-particle statistics. The interfaced expect by that implementation should be documented.