DOC: add proper documentation

[vkhodygo]

• There is a giant docstring that goes before all imports, that looks like a feature of CellProfiler;
• Functions are poorly documented;
• Comments mark logical blocks that can be moved to separate functions (see MAINT: split functions #25)