docs: explain hacks, note changes to views