add docs and enable tweaking to work