add variable intro and do's and don'ts