updating design notes - see new Pipe DSL