in-code docs have hrefs to non-existant pages

e.g. https://github.com/apache/incubator-openwhisk-package-cloudant/blob/master/actions/account-actions/read-database.js

which has a link https://docs.cloudant.com/database.html#read

which now resolves to https://console.bluemix.net/docs/services/Cloudant/getting-started.html#read, which does not document read-database.

for this one, maybe the updated link should be https://console.bluemix.net/docs/services/Cloudant/api/database.html#getting-database-details

but a more thorough auditing is necessary

Start with actions/account-actions/read-database.js and inspect its Cloudant documentation hrefs, including the database read link cited in the issue. Compare each destination with the current Cloudant documentation and identify non-existent or outdated pages. Done means the in-code links have been audited and updated to valid, relevant destinations.

Written by the indexing model from the issue text.