documentation for scatter code

So far I've just added some basic documentation to the random quaternion c code.

NOT ready for merge.