handle notes in *.jbuilder files, updated rspecs and documentation