fix use of 'important' directive and re-build docs