many updates across documentation and code.  On the way to sharing.