Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 110 lines (74 sloc) 4.251 kb
d7efa3ea »
2011-01-26 improved docs
1 =========================================
2 Contributing to GeoCam
3 =========================================
4
5 The GeoCam Project develops open source software and we welcome your
6 contributions. We think making tools to help disaster responders share
7 information in the field is just about the greatest job in the world,
8 and if you have the time to help us, that's awesome. You're really
9 doing some important public service.
10
11 If you're a developer and want to get involved, here are some ways you
12 can do that:
13
14 * We use ``git`` and the GitHub web site to manage our source code.
15 You can read up on these tools at the `GitHub help pages`_.
16
23b66ff0 »
2011-01-26 improved docs
17 * Try using our tools:
18
19 * Visit an `interactive demo version`_ of GeoCam Share. This is a
20 read-only version that can give you a feel for how the display works.
21
22 * Our Android native apps are currently in closed beta. If you want to
23 try them out, please contact a project member.
d7efa3ea »
2011-01-26 improved docs
24
25 * If you find any bugs, you can help us out by reporting them at the
26 `issue tracker`_. You can get to the issue tracker by clicking
27 on the ``Issues`` button from any GeoCam repository on GitHub. You
28 can also vote on which bugs are most important to you.
29
23b66ff0 »
2011-01-26 improved docs
30 * Try installing our tools from source:
31
32 * `Installation instructions for GeoCam Share`_
33
34 * `Installation instructions for GeoCam native Android apps`_
35
36 * If you're thinking of contributing changes, you'll want to use
37 ``git`` to grab the source instead of clicking the ``Downloads``
38 button.) Please report any errors you find in our installation
39 instructions using the issue tracker.
d7efa3ea »
2011-01-26 improved docs
40
41 * If you have any questions, ask on the `geocam-questions group`_.
42 That will also give us a chance to get to know you, which will make
43 things easier if you want to contribute code later.
44
45 * You're free to test whatever changes you like in your local repository,
46 and you can share them (subject to the `NASA Open Source Agreement`_) by
47 `forking`_ our repository on GitHub and pushing your changes there.
48
49 * If we like your changes, we might incorporate them into the master copy
50 of GeoCam. But remember:
51
52 * We only take changes if they fit with our project goals and our
53 coding style. You have better odds of getting your changes
54 accepted if we've talked about them in advance.
55
56 * Unfortunately, we can only take changes if you have signed our
57 contributor license agreement (see below). That agreement is what
58 lets us legally redistribute your changes under the NOSA.
59
60 * To give us a change, push it to your fork on GitHub, then send us a
61 `pull request`_ so we can pull it from there. (Or if you prefer,
62 send a pull request via email with any explanation needed, no need
63 to get formal.)
64
65 .. _pull request: http://help.github.com/pull-requests/
66
67 .. _GitHub help pages: http://help.github.com/
68
69 .. _geocam-questions group: http://groups.google.com/group/geocam-questions
70
71 .. _NASA Open Source Agreement: http://github.com/geocam/geocamShare/tree/master/COPYING
72
73 .. _forking: http://help.github.com/forking/
74
75 .. _interactive demo version: http://geocamshare.org/demo/share
76
77 .. _issue tracker: https://github.com/geocam/geocamShare/issues
78
23b66ff0 »
2011-01-26 improved docs
79 .. _Installation instructions for GeoCam Share: http://github.com/geocam/geocamShare/tree/master/docs/install.rst
80
81 .. _Installation instructions for GeoCam native Android apps: http://github.com/geocam/geocamMobileForAndroid/tree/master/docs/install.rst
d7efa3ea »
2011-01-26 improved docs
82
83
84 Contributor License Agreement
85 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
86
87 In order for us to accept your changes into the master GeoCam
88 repository, we need you to submit a signed copy of our
89 `contributor license agreement`_ (PDF). That agreement is what
90 lets us legally redistribute your changes under the NOSA.
91
92 Please print the agreement, sign it, and mail it to the following
93 address::
94
95 Trey Smith
96 NASA Ames Research Center, Mail Stop 269-3
97 Moffett Field, CA 94035
98 USA
99
100 Thanks! We hope to hear from you!
101
102 .. http://geocamshare.org/docs/contributorLicenseAgreement.pdf
103
104
105 | __BEGIN_LICENSE__
106 | Copyright (C) 2008-2010 United States Government as represented by
107 | the Administrator of the National Aeronautics and Space Administration.
108 | All Rights Reserved.
109 | __END_LICENSE__
Something went wrong with that request. Please try again.