corrected spelling
made return types explicit and more specific
renamed allele generator
added some base doc