add documentation and remove superfluous path converters