add fullstop in short desc.; finish long desc. + discussion points