doc in progress (see #11 and #12).