more sensible kwarg naming
added fs examples from bliss