add comments and code snippets concerning optional paramters and default values