Most documentation is missing

[montibbalt]

At least add a comment to a supermajority of public functions

• document whether functions fully evaluate an iterable, and warn about infinite sequences
• add at least a short note about what each type is