[doc] take a second pass at explaining log.in, see #304