Docs should be detailed, easy to read, and packed with examples.
But aside from all the examples and tutorials, please don't forget about a proper manual and full API docs. I've seen too many different tools and tech that have spent a lot of money on writing up the happy path, but then completely left me on my own when I encountered some weird error code.
Just follow the structure of the whole API you have, and make sure that each member, each function argument and each possible return value is documented. It's not as glamorous as "one button integration" - but that one button integration usually turns into nightmare when you want to wire it up to your automatic builds anyway.
Comments
But aside from all the examples and tutorials, please don't forget about a proper manual and full API docs. I've seen too many different tools and tech that have spent a lot of money on writing up the happy path, but then completely left me on my own when I encountered some weird error code.
Just follow the structure of the whole API you have, and make sure that each member, each function argument and each possible return value is documented. It's not as glamorous as "one button integration" - but that one button integration usually turns into nightmare when you want to wire it up to your automatic builds anyway.