some (incomplete) documentation for wiring things up