updated docs, added to .gitignore, fixed a bug in filter