update doc. add warning for writing Python code