more docs and fixed frequency representation