notes from spec