Add comments for auto-generated API docs about hoodie-account-client HOT 4 OPEN

I think you forgot to copy/paste the example? :)

from hoodie-account-client.

@Charlotteis the example is this part here:

/**
 * tries to find object in local database, otherwise creates new one
 * with passed properties.
 *
 * @param  {String|Object} idOrObject   id or object with `.id` property
 * @param  {Object}        [properties] Optional properties if id passed
 *                                      as first option
 * @return {Promise}
 */

It's a special format of JavaScript comments, that follows the conventions of JSDoc. The basic idea is: keep your code & documentation together, to help keeping your docs & sync in place. It's very interesting and I think http://usejsdoc.org/ is worth checking out.

If you like to play with it, add some comments, then run npm run docs locally, and then open /docs/build/index.html

from hoodie-account-client.

Cheers!

from hoodie-account-client.

I'd love to take a look this one @Charlotteis !

from hoodie-account-client.