Apiary covers the first theme to a first class standard  and you will see Apiary called out for its ability to document APIs in a lot of articles Well written API Blueprints will cover the bulk of the second bullet