--- type: none --- Full doc coverage of the api and related cleanup