add "How it works" section
make difference between cspecs explicit