doc in progress - see #12