updated docs & Y.when function