-
Notifications
You must be signed in to change notification settings - Fork 9
/
how-to-contribute.html
191 lines (163 loc) · 10.2 KB
/
how-to-contribute.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<!--
Copyright (C) 2005, 2006 Joe Walnes.
Copyright (C) 2006, 2007, 2008, 2021 XStream committers.
All rights reserved.
The software in this package is published under the terms of the BSD
style license a copy of which has been included with this distribution in
the LICENSE.txt file.
Created on 29. January 2005 by Joe Walnes
-->
<head>
<title>XStream - How to Contribute</title>
<link rel="stylesheet" type="text/css" href="style.css"/>
<!-- Google analytics -->
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-110973-2";
urchinTracker();
</script>
</head>
<body>
<div id="banner">
<a href="index.html"><img id="logo" src="logo.gif" alt="XStream"/></a>
</div>
<div id="center" class="Content2Column"> <!-- Content3Column for index -->
<div id="content">
<h1 class="FirstChild">How to Contribute</h1>
<p>XStream is nothing without contributions from the user community. There are many ways to
contribute. We are constantly working on the software and documentation, so it's a good
idea to contact the team. For question about usage or possible misbehavior, please contact
us on the <a href="mailing-lists.html">mailing list</a>. This is also the place to discuss further
development of XStream.</p>
<h2 id="help">Help</h2>
<p>The correct place if you are looking for help is the <a href="mailing-lists.html">mailing list</a>. You
get there a much wider audience from other users and also the developers are reading and answering there
your questions.</p>
<h2 id="documentation">Documentation</h2>
<p>One of the traditional weak points of open source software is the documentation. Any
help with this aspect of the project will be welcomed with open arms, or at the very least
with open email clients!</p>
<h2 id="examples">Examples</h2>
<p>We are working on one or two examples of using XStream, but we can always do with more.</p>
<h2 id="feature-requests">Feature Requests</h2>
<p>We eat our own dogfood, but we're also happy to feed other people's dogs (if you'll excuse
a stretched <span style="text-decoration:line-through">dachshund</span> metaphor!). If you want to
request a new feature you can either make a request through the <a href="issues.html">issue tracker</a>
or by sending a message to the <a href="mailing-lists.html">mailing list</a>. The benefit of any
new features will be discussed on the mailing list, so its a good idea to sign up so that you can stick your
oar in.</p>
<h2 id="bug-reports">Bug Reports</h2>
<p>You can report bugs through the <a href="issues.html">issue tracker</a> interface or in case you are
in doubt whether it is really a bug or just a wrong usage, you may ask first posting to the
<a href="mailing-lists.html">mailing list</a>. Additional brownie points are awarded for bug reports that
include a failing unit test.</p>
<h2 id="patches">Bug Fixes</h2>
<p>If you want <em>lots</em> of brownie points, send a fix along with your bug report
and failing unit test. Bug fixes are best sent as patches that we can apply to the
codebase. Remember to tell us which version the patch should be applied against, or
we'll get very confused. To be accepted into the codebase, patches must be released
under the <a href="license.html">same license as XStream itself</a>.</p>
<h2 id="new-code">New Code</h2>
<p>If you have a new feature request, then we'll listen extra hard if you show us how it
works. A new feature might be best implemented as a patch to an existing class
or as a new class. The XStream API contains many extension points that allow new functionality
to be integrated into the framework. We are rather anal about testing, so if you send us
some code without any tests we will probably ask you to write the tests tests as well
before we add it to the codebase.</p>
<h2 id="your-own-extension">Write Your Own XStream Extension</h2>
<p>If you have a project that builds upon XStream we will be happy to announce your
project on the XStream site.</p>
<h2 id="become-committer">Become a Committer</h2>
<p>We follow the former Codehaus manifesto when it comes to expanding the core team.</p>
<ol>
<li>The Codehaus recognizes that some committers, based upon metrics, longevity and appointed
management, have greater say on a project than others.</li>
<li>The Codehaus is a place where people are encouraged to get on with code rather than tie
their projects up with bureaucracy.</li>
<li>The Codehaus encourages projects to strive for quality and for frequent small releases.</li>
<li>The Codehaus encourages committers to be respectful friends, meet up with each other as often
as possible. Face-to-face is superior to email.</li>
<li>The Codehaus stands in favour of diversity (where appropriate) over enforced convergence and
homogeneity.</li>
<li>The Codehaus places a high bar on entry for committers. Referral is a common means. A new
committer is expected to show strong character elements as well as a talent for code. Maturity and
wisdom (possibly in advance of years if a youngster) should be demonstrated.</li>
<li>New committers to an existing project are expected to ease themselves in with small and deferrent
commits to start, and greater free-will may be assumed later.</li>
<li>The Codehaus encourages people to be brief in email and to honor internet etiquette. Ten furlongs
of text justifying a position is poor form; better would be a (failing) unit test.</li>
<li>In case of disagreement, The Despots are right.</li>
</ol>
<br/>
</div>
</div>
<div class="SidePanel" id="left">
<div class="MenuGroup">
<h1>Software</h1>
<ul>
<li><a href="index.html">About XStream</a></li>
<li><a href="news.html">News</a></li>
<li><a href="changes.html">Change History</a></li>
<li><a href="security.html">Security Aspects</a></li>
<li><a href="versioning.html">About Versioning</a></li>
</ul>
</div>
<div class="MenuGroup">
<h1>Evaluating XStream</h1>
<ul>
<li><a href="tutorial.html">Two Minute Tutorial</a></li>
<li><a href="license.html">License</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="references.html">References</a></li>
<li><a href="benchmarks.html">Benchmarks</a></li>
<li><a href="https://www.openhub.net/p/xstream">Code Statistics</a></li>
</ul>
</div>
<div class="MenuGroup">
<h1>Using XStream</h1>
<ul>
<li><a href="architecture.html">Architecture Overview</a></li>
<li><a href="graphs.html">Object references</a></li>
<li><a href="manual-tweaking-output.html">Tweaking the Output</a></li>
<li><a href="converters.html">Converters</a></li>
<li><a href="faq.html">Frequently Asked Questions</a></li>
<li><a href="mailing-lists.html">Mailing Lists</a></li>
<li><a href="issues.html">Reporting Issues</a></li>
</ul>
</div>
<div class="MenuGroup">
<h1>Javadoc</h1>
<ul>
<li><a href="javadoc/index.html">XStream Core</a></li>
<li><a href="hibernate-javadoc/index.html">Hibernate Extensions</a></li>
<li><a href="jmh-javadoc/index.html">JMH Module</a></li>
</ul>
</div>
<div class="MenuGroup">
<h1>Tutorials</h1>
<ul>
<li><a href="tutorial.html">Two Minute Tutorial</a></li>
<li><a href="alias-tutorial.html">Alias Tutorial</a></li>
<li><a href="annotations-tutorial.html">Annotations Tutorial</a></li>
<li><a href="converter-tutorial.html">Converter Tutorial</a></li>
<li><a href="objectstream.html">Object Streams Tutorial</a></li>
<li><a href="persistence-tutorial.html">Persistence API Tutorial</a></li>
<li><a href="json-tutorial.html">JSON Tutorial</a></li>
<li><a href="http://www.studytrails.com/java/xml/xstream/xstream-introduction.jsp">StudyTrails</a></li>
</ul>
</div>
<div class="MenuGroup">
<h1>Developing XStream</h1>
<ul>
<li class="currentLink">How to Contribute</li>
<li><a href="team.html">Development Team</a></li>
<li><a href="repository.html">Source Repository</a></li>
<li><a href="https://travis-ci.org/x-stream/xstream/branches">Continuous Integration</a></li>
</ul>
</div>
</div>
</body>
</html>