[doc] write some notes about the science