If you have a question about Mongoose (not a bug report) please post it to either StackOverflow, or on Gitter
- Before opening a new issue, look for existing issues to avoid duplication. If the issue does not yet exist, create one.
- Please post any relevant code samples, preferably a standalone script that reproduces your issue. Do not describe your issue in prose, show your code.
- If the bug involves an error, please post the stack trace.
- Please post the version of mongoose and mongodb that you're using.
- Please write bug reports in JavaScript (ES5 or ES2015), not coffeescript, typescript, etc.
- Before opening a new issue, look for existing issues to avoid duplication. If the issue does not yet exist, create one.
- Please describe a use case for it
- it would be ideal to include test cases as well
- Before starting to write code, look for existing issues. That way you avoid working on something that might not be of interest or that has been addressed already in a different branch. You can create a new issue here.
- The source of this project is written in javascript, not coffeescript, therefore your bug reports should be written in javascript.
- Fork the repo or for small documentation changes, navigate to the source on github and click the Edit button.
- Follow the general coding style of the rest of the project:
- 2 space tabs
- no trailing whitespace
- inline documentation for new methods, class members, etc.
- 1 space between conditionals, no space before function parenthesis
if (..) {
for (..) {
while (..) {
function(err) {
- Write tests and make sure they pass (tests are in the test directory).
- Open a terminal and navigate to the root of the project
- execute
npm install
to install the necessary dependencies - start a mongodb instance on port 27017 if one isn't running already.
mongod --dbpath <path to store data> --port 27017
- execute
npm test
to run the tests (we're using mocha)- or to execute a single test
npm test -- -g 'some regexp that matches the test description'
- any mocha flags can be specified with
-- <mocha flags here>
- For example, you can use
npm test -- -R spec
to use the spec reporter, rather than the dot reporter (by default, the test output looks like a bunch of dots)
- or to execute a single test
To contribute to the API documentation just make your changes to the inline documentation of the appropriate source code in the master branch and submit a pull request. You might also use the github Edit button.
To contribute to the guide or quick start docs, make your changes to the appropriate .jade
files in the docs directory of the master branch and submit a pull request. Again, the Edit button might work for you here.
If you'd like to preview your documentation changes, first commit your changes to your local master branch, then execute:
make docclean
make gendocs
node static.js
Visit http://localhost:8088
and you should see the docs with your local changes. Make sure you git reset --hard
before commiting, because changes to docs/*
should not be in PRs.
The plugins site is also an open source project that you can get involved with. Feel free to fork and improve it as well!