particle-swarm: Add more documentation