add notes and readme and standalone spec