docs: update docs with new directives & changes