-
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
Add note to point devs at @most/core for new projects #526
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Tiny language update.
README.md
Outdated
@@ -13,6 +13,16 @@ _ / / / / /_/ /____/ /_ / | |||
[![Build Status](https://travis-ci.org/cujojs/most.svg?branch=master)](https://travis-ci.org/cujojs/most) | |||
[![Join the chat at https://gitter.im/cujojs/most](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/cujojs/most?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) | |||
|
|||
## Starting a new project? | |||
|
|||
Strongly consider starting with [`@most/core`](https://github.com/mostjs/core). It is the foundation of the upcoming most 2.0, has [improved documentation](http://mostcore.rtfd.io/), new features, better tree-shaking build characteristics, and simpler APIs. Updating from `@most/core` to most 2.0 will be simple and non-breaking. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Update to avoid over-used words, such as “simple”:
Strongly consider starting with @most/core
. It is the foundation of the upcoming most 2.0, has improved documentation, new features, better tree-shaking build characteristics, and simpler APIs. Updating from @most/core
to most 2.0 will be non-breaking and straightforward.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, updated.
I added the same note to the top of the API docs in 4934638 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice!
Summary
@most/core
is the future of mostjs, and most 2.0 is close. Most 2.0 will be based on@most/core
, will be directly compatible with it, and will be a trivial upgrade for folks who prefer a single dependency in their package.json.The goal of this addition is to help devs make a more forward-compatible choice for new projects and let them know there will be a guide to help them upgrade existing projects. It encourages devs to pick
@most/core
now for new projects, and points existing most 1.x-based projects to the upgrade guide (still a WIP as of this writing).