add source docs
more work on docs, ui clarifications