doc: add missing 'improvements' section markup
doc: fix a typo