Skip to content
This repository was archived by the owner on Mar 10, 2020. It is now read-only.

[WIP] Awesome API Documentation #469

Closed
wants to merge 3 commits into from
Closed

[WIP] Awesome API Documentation #469

wants to merge 3 commits into from

Conversation

dignifiedquire
Copy link
Contributor

@dignifiedquire dignifiedquire commented Dec 6, 2016

*
* @memberof Api#
*
* @example
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As I understand our previous discussions, examples should make use of callbacks, not promises.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

feel free to change

* @alias add
* @method
* @param {(Buffer|Stream|Array<Buffer|Stream>)} files - The content to add.
* @param {function(Error, {hash: string})} [callback]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't we get the file in the callback rather than a String with the hash?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add only returns the hash as far as I know

src/index.js Outdated
* // or using options
* const ipfs = ipfsAPI({host: 'localhost', port: '5001', procotol: 'http'})
*/
function Api (hostOrMultiaddr, port, opts) {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why this changed to just Api from IpfsAPI? Having ipfs in the name helps when dealing with stacktraces

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can't remember, feel free to change back

src/index.js Outdated
*
* @constructor Api
* @param {string} hostOrMultiaddr
* @param {number} port
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Param says number but example is using string

@victorb victorb removed their assignment Dec 12, 2016
@alanshaw
Copy link
Contributor

alanshaw commented Nov 5, 2019

Closing as this PR is significantly out of date and unlikely to be completed.

@alanshaw alanshaw closed this Nov 5, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants