-
Notifications
You must be signed in to change notification settings - Fork 231
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Include most.create in API docs #341
Comments
had an idea about this thought i would run it by you guys... instead of adding that list all of the current stream modules in https://github.com/mostjs and maybe even https://github.com/mostjs-community it gives both exposure and a nice way to add external modules into the README thoughts? |
@davidchase That's an interesting idea. Are you thinking we'd put the list directly in the README, or do you see it living in the wiki? @Rich-Harris What do you think of that idea? Do you think it would have helped you discover |
@briancavalier yeah i can see it in the README just because its right there... might be "better" found because its the 1st thing anyone sees when they are coming to a github repo. I sometimes myself forget about the wiki feature 😞 |
Follow up to Gitter discussion:
For folks like me who are coming to most.js without a reactive programming background, it can be a very steep learning curve. One of the things that would make it much easier to adopt streams incrementally (both as a mental concept and in a codebase) is an obvious escape hatch for when you need to write some dirty old-fashioned imperative code.
most.create
seems to fit that bill perfectly, but it took me a very long time to discover it (and when I did, it was by accident – a throwaway remark in an unrelated thread). I propose adding it to the 'creating streams' section of the API docs, but with a health warning, perhaps something along the following lines:The text was updated successfully, but these errors were encountered: