version: add notes + definitions