doc: clearify some points