Capturing some FTS API notes from communication with Sean Foo