add an example
add link to api documentation from reference index