1- Contributing to the MongoDB Legacy C++ Client Driver Project
2- ===================================
1+ ## Contributing to the MongoDB Legacy C++ Driver Project
32
43Pull requests are always welcome, and the MongoDB dev team appreciates any help the community can
54give to help make MongoDB better.
65
76For any particular improvement you want to make, you can begin a discussion on the
8- ` MongoDB Developers Forum `_. This is the best place discuss your proposed improvement (and its
7+ [ MongoDB Developers Forum] [ dev-forum ] . This is the best place discuss your proposed improvement (and its
98implementation) with the core development team.
109
11- .. _ MongoDB Developers Forum : https://groups.google.com/forum/?fromgroups#!forum/mongodb-dev
10+ [ dev-forum ] : https://groups.google.com/forum/?fromgroups#!forum/mongodb-dev " MongoDB Developers Forum "
1211
1312
14- Getting Started
15- ---------------
13+ ## Getting Started
1614
17- - Create a ` MongoDB JIRA account `_ .
18- - Create a ` Github account `_ .
15+ - Create a [ MongoDB JIRA account] [ jira-account ] .
16+ - Create a [ Github account] [ github-account ] .
1917- Fork the repository on Github at https://github.com/mongodb/mongo-cxx-driver .
2018- Check out the 'legacy' branch 'git checkout legacy'
2119
22- .. _ MongoDB JIRA account : https://jira.mongodb.org/secure/Signup!default.jspa
23- .. _ Github account : https://github.com/signup/free
20+ [ jira- account] : https://jira.mongodb.org/secure/Signup!default.jspa " MongoDB JIRA Signup "
21+ [ github- account] : https://github.com/signup/free " Githup Signup "
2422
2523
26- JIRA Tickets
27- ------------
24+ ## JIRA Tickets
2825
29- All commits to the C++ driver repository must reference an issue in the ` CXX project `_ of the
30- MongoDB JIRA. Before creating any new tickets, please search the existing backlog for any open
31- tickets that represent your change request. If there is not one, then you should create a new
32- ticket. Tickets specific to the legacy driver should be filed the label ` legacy-cxx `_ .
26+ All commits to the C++ driver repository must reference an issue in the [ CXX project] [ cxx-project ]
27+ of the MongoDB JIRA. Before creating any new tickets, please search the existing backlog for any open
28+ tickets that represent your change request. If there is not one, then you should create a new
29+ ticket. Tickets specific to the legacy driver should be filed the label [ legacy-cxx] [ legacy-cxx ] .
3330
3431For bugs, please clearly describe the issue you are resolving, including the platforms on which
3532the issue is present and clear steps to reproduce.
3633
3734For improvements or feature requests, be sure to explain the goal or use case and the approach
3835your solution will take.
3936
40- .. _ SERVER project : https://jira.mongodb.org/browse/CXX
41- .. _ legacy -cxx : https://jira.mongodb.org/browse/CXX-69?jql=labels%20%3D%20legacy-cxx
37+ [ cxx- project] : https://jira.mongodb.org/browse/CXX
38+ [ legacy -cxx] : https://jira.mongodb.org/browse/CXX-69?jql=labels%20%3D%20legacy-cxx
4239
4340
44- The Life Cycle of a Pull Request
45- --------------------------------
41+ ## The Life Cycle of a Pull Request
4642
4743Here's what happens when you submit a pull request:
4844
@@ -51,30 +47,27 @@ Here's what happens when you submit a pull request:
5147- You should receive a response from one of our engineers with additional questions about your
5248 contributions.
5349- If your pull request matches a ticket and is aligned with the Server Roadmap, it will get
54- triaged and reviewed by the Kernel team .
50+ triaged and reviewed by the C++ driver and Kernel teams .
5551- Pull requests that have been reviewed and approved will be signed off and merged into a
5652 development branch and the associated JIRA CXX issue will be resolved with an expected
5753 fixVersion.
5854
5955
60- Style Guide
61- -----------
56+ ## Style Guide
6257
63- All commits to the legacy branch must follow the ` kernel development rules `_ .
58+ All commits to the legacy branch must follow the [ kernel development rules] [ kernel-dev-rules ] .
6459
65- In particular, all code must follow the MongoDB ` kernel code style guidelines `_. For anything
66- not covered in this document you should default to the ` Google CPP Style Guide `_ .
60+ In particular, all code must follow the MongoDB [ kernel code style guidelines] [ kernel-style-guide ] .
61+ For anything not covered in this document you should default to the [ Google CPP Style Guide] [ google-style-guide ] .
6762
68- Your commit message should also be prefaced with the relevant JIRA ticket, e.g. "CXX-XXX Fixed
69- a bug in aggregation".
63+ Your commit message should also be prefaced with the relevant JIRA ticket, e.g. "CXX-XXX Fixed a bug in aggregation".
7064
71- .. _ kernel development rules : http://dochub.mongodb.org/core/kernelcodedevelopmentrules
72- .. _ Kernel Code Style guidelines : http://dochub.mongodb.org/core/kernelcodestyle
73- .. _ Google CPP Style Guide : http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml
65+ [ kernel-dev- rules] : http://dochub.mongodb.org/core/kernelcodedevelopmentrules
66+ [ kernel-style-guide ] : http://dochub.mongodb.org/core/kernelcodestyle
67+ [ google-style-guide ] : http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml
7468
7569
76- Testing
77- -------
70+ ## Testing
7871
7972Every non-trivial change to the code base should be accompanied by a relevant addition to or
8073modification of the test suite. If you don't believe this is necessary, please add an explanation
@@ -84,10 +77,9 @@ All changes must also pass the full test suite (including your test additions/ch
8477local machine before you open a pull request.
8578
8679
87- Contributor Agreement
88- ---------------------
80+ ## Contributor Agreement
8981
9082A patch will only be considered for merging into the upstream codebase after you have signed the
91- ` contributor agreement `_ .
83+ [ contributor agreement] [ contributor-agreement ] .
9284
93- .. _ contributor agreement : http://www.mongodb.com/contributor
85+ [ contributor- agreement] : http://www.mongodb.com/contributor " MongoDB Contributor Agreement "
0 commit comments