support older python/numpy and few doc clarifications
(#547)