added some explanation to docs