rsvp.js icon indicating copy to clipboard operation
rsvp.js copied to clipboard

API docs?

Open graue opened this issue 11 years ago • 12 comments

I've scanned the readme for this project several times, and maybe I'm missing it, but I don't see a link to the API docs. Do they exist? Where?

graue avatar Mar 30 '14 04:03 graue

RSVP hasn't it's own site, yet. You could either:

  • Use Ember's doc site

    http://emberjs.com/api/classes/Ember.RSVP.html http://emberjs.com/api/classes/Ember.RSVP.Promise.html

  • Use the spec

    https://github.com/domenic/promises-unwrapping

  • Or read the code comments

MajorBreakfast avatar Mar 30 '14 07:03 MajorBreakfast

We should likely create a quick API site/page at some point

stefanpenner avatar Mar 30 '14 14:03 stefanpenner

Where would the new site/page live? I'm guessing an initial version would start with just the API docs from code. The same docs used for Ember Data at the Emberjs.com site?

mikepmunroe avatar Mar 30 '14 23:03 mikepmunroe

likely just a github page. Ya we have YUIdoc so it wouldn't be hard to generate and drop them somewhere else.

stefanpenner avatar Mar 31 '14 00:03 stefanpenner

FYI, looks like the docs have been removed from Ember API site. Not sure if intentional?

adamesque avatar Aug 28 '14 16:08 adamesque

@adamesque accidental, I believe WIP exists to restore.

I am also going to work towards an RSVP.js website.

stefanpenner avatar Aug 28 '14 17:08 stefanpenner

We could use the Wiki on this repository.

jpotterm avatar Sep 02 '14 02:09 jpotterm

@jpotterm the source contains very detailed docs. I don't think also adding a wiki is a good idea. I hope to give rsvp its own site in the next month or so. Then the docs will be more up and center

stefanpenner avatar Sep 02 '14 04:09 stefanpenner

updated url for ember docs

http://emberjs.com/api/classes/RSVP.html

a little incomplete though

billybonks avatar Mar 07 '15 07:03 billybonks

+1 for just adding some examples, use cases and brief documentation to the Github wiki. Why not?

robksawyer avatar Jun 04 '15 01:06 robksawyer

Sorry for bumping this but I didn't want to create a new issue. The definitions on the url seem to be broken (for everything relating to RSVP). Eg: https://www.emberjs.com/api/classes/RSVP.Promise.html Any ideas on how to fix this?

tchan avatar May 11 '17 05:05 tchan

@travismchan likely an issue with the ember website

stefanpenner avatar May 11 '17 06:05 stefanpenner