doc: add YARD configuration file
navigator: document some methods as attributes
window: add some docs and make alert return the passed value