summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorWisdom Omuya <deafgoat@gmail.com>2015-01-13 12:43:10 -0500
committerWisdom Omuya <deafgoat@gmail.com>2015-01-22 11:42:59 -0500
commit9a49c113cfb7a27146f66aa54368e2dc73045a3a (patch)
treeffb1c43b7b0c02169285b7f30c50d3ddc4db3e13 /README.md
parentaff875f788ff5348ffcc76278ab66b1725df18e9 (diff)
downloadmongo-9a49c113cfb7a27146f66aa54368e2dc73045a3a.tar.gz
TOOLS-309: add contribution guide
Diffstat (limited to 'README.md')
-rw-r--r--README.md21
1 files changed, 16 insertions, 5 deletions
diff --git a/README.md b/README.md
index f83e78b0030..495ea6415d3 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,5 @@
-# MongoDB Tools
+MongoDB Tools
+===================================
This is the 2.7.x **unstable** branch. This project is a work in progress.
@@ -11,10 +12,10 @@ This is the 2.7.x **unstable** branch. This project is a work in progress.
- **mongooplog** - _Replay oplog entries between MongoDB servers_
- **mongotop** - _Monitor read/write activity on a mongo server_
-Report any bugs, improvements, or new feature requests at https://jira.mongodb.org/browse/tools
+Report any bugs, improvements, or new feature requests at https://jira.mongodb.org/browse/TOOLS
-
-####Setup
+Setup
+---------------
Clone the repo and run `. ./set_gopath.sh` (`set_gopath.bat` on Windows) to setup your GOPATH:
```
@@ -23,7 +24,8 @@ cd mongo-tools
. ./set_gopath.sh
```
-#### Building Tools
+Building Tools
+---------------
To build the tools, you need to have Go version 1.3 and up.
An additional flag, `-tags`, can be passed to the `go build` command in order to build the tools with support for SSL and/or SASL. For example:
@@ -34,3 +36,12 @@ go build -o bin/mongoimport mongoimport/main/mongoimport.go # build mongoimport
go build -o bin/mongoimport -tags ssl mongoimport/main/mongoimport.go # build mongoimport with SSL support enabled
go build -o bin/mongoimport -tags "ssl sasl" mongoimport/main/mongoimport.go # build mongoimport with SSL and SASL support enabled
```
+
+Contributing
+---------------
+See our [Contributor's Guide](CONTRIBUTING.md).
+
+Documentation
+---------------
+See the MongoDB packages [documentation](http://docs.mongodb.org/master/reference/program/).
+