add some notes and todo about params