first attempt to document core