initial draft documentation of spi api