Why not both? Good documentation with a reference implementation seems like the optimal choice. They're going to have to write the reference implementation anyway.