add in doc and update sample scripts