improve explanations on example structure
fixed use of docstrings + added section in whats_new.rst + added data dir to .gitignore