first attempt to document core

yes, sounds better.