adds docs changes, refactor dates patterns