common: some notes and compile fixes