document instantiate spec