nodejs/promises

Glossary

chrisdickinson opened this issue · 2 comments

There are a lot of terms in play here, between async/await, post-mortem, Promises, and the error symposium. I will write a glossary defining common terms so that we can rely on it to ensure we're all talking about the same things.

Yes definitely. This is also related to #7

Some issues:

  • Promise Resolution
    • Rejection
    • Fulfillment
  • Recursive Assimilation
  • Promises/A+
  • Promises/A
  • ES2015 Promises
  • Promises as a DSL
  • Microtask vs. Microtask scheduling semantics in promises
  • Revealing constructor pattern
  • Deferred.
  • User Promise Implementations Q, When, Bluebird and RSVP
  • Promise chaining and error propagation
  • Unhandled Rejection hooks
  • Operational Error Propagation
  • Explicit Construction AntiPattern
  • Promise Disposer Pattern
  • Multicast vs. Unicast
  • Then second argument vs .catch
  • How to convert a callback API to promises.
  • Promise error handling model.
  • Promise cancellation
  • Promise progression

I have answers defining most of these on Stack Overflow. Others like @bergus also have a lot of useful content. @spion has a lot of useful stuff in promise-nuggets and his blog.

Feel free to use anything from my posts there - I can create this content or help creating it. I don't mind stepping up and organizing the effort.

Where would such a thing be hosted and in what format?

I'll PR it to this WG as a GLOSSARY.md. It won't be an exhaustive catalog of terms, but should provide the minimum to make sure participants aren't talking past each other. It will include terms from post-mortem debugging as well as promises.