add docs

Created by: zeffii

leaves some documentation for readers to reflect on

addresses findings mentioned in https://github.com/nortikin/sverchok/issues/3731