-
Notifications
You must be signed in to change notification settings - Fork 1.8k
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
chore: format readme and add note about 4.0 beta #2729
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.
your changes look pretty good but I'm looking through the whole README and a lot of it seems very old and probably outdated? doesn't have to be done right now but I think before 4.0 GA we should try to tidy this up a lot
README.md
Outdated
[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mongodb/node-mongodb-native?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) | ||
|
||
# Description | ||
[![npm](https://nodei.co/npm/mongodb.png?downloads=true&downloadRank=true)](https://nodei.co/npm/mongodb/) | ||
|
||
The official [MongoDB](https://www.mongodb.com/) driver for Node.js. Provides a high-level API on top of [mongodb-core](https://www.npmjs.com/package/mongodb-core) that is meant for end users. |
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.
mention of core seems irrelevant now that we merged the repos, want to take that out?
README.md
Outdated
* [bson](https://github.com/mongodb/js-bson) | ||
* [kerberos](https://github.com/mongodb-js/kerberos) | ||
* [node-gyp](https://github.com/nodejs/node-gyp) | ||
- [mongodb-core](https://github.com/mongodb-js/mongodb-core) |
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.
also outdated I think? this seems maybe a bit oudated in general?
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.
lgtm, could you please open a ticket about a more thorough editing before 4.0 GA?
README.md
Outdated
@@ -196,7 +197,7 @@ const dbName = 'myproject'; | |||
// Use connect method to connect to the server | |||
MongoClient.connect(url, function(err, client) { |
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.
Would we want to change the example to use the MongoClient
constructor instead? (Just to get people in the habit of doing that since if they want to listen to events from the very beginning, like SDAM events, they will need to register the handlers before connecting)
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.
SGTM
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.
LGTM. Thanks!
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.
LGTM! Just had a few suggestions.
README.md
Outdated
|
||
# Installation | ||
## Installation | ||
|
||
The recommended way to get started using the Node.js 3.0 driver is by using the `npm` (Node Package Manager) to install the dependency in your project. |
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.
The recommended way to get started using the Node.js 3.0 driver is by using the `npm` (Node Package Manager) to install the dependency in your project. | |
The recommended way to get started using the Node.js driver is by using `npm` (Node Package Manager) to install the dependency in your project. |
README.md
Outdated
**Looking for the latest?** We're working on the next major version of the driver now in beta. | ||
Check out our [beta version 4.0 here](https://github.com/mongodb/node-mongodb-native/tree/4.0). |
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.
**Looking for the latest?** We're working on the next major version of the driver now in beta. | |
Check out our [beta version 4.0 here](https://github.com/mongodb/node-mongodb-native/tree/4.0). | |
### Version 4.0 | |
**Looking for the latest?** We're working on the next major version of the driver, now in beta. | |
Check out our [beta version 4.0 here](https://github.com/mongodb/node-mongodb-native/tree/4.0), which includes a full migration of the driver to TypeScript. |
I think adding a heading and a mention of TypeScript would help draw attention to the beta.
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.
LGTM 👍
Added a small note at the top of the readme about 4.0 beta, let me know if we want to make it more noticable somehow
(Also ran prettier on the readme which makes the code examples match our code style)