first attempt to document core

done