add docs and set default behaviour to one level