summaryrefslogtreecommitdiff
path: root/ACE/docs/ACE-bug-process.html
blob: d727320f4203ceccf2a5a54dfa34f4751523656c (plain)
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
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
<!--  -->

<HTML>
    <TITLE>ACE, TAO, CIAO and DAnCE Bug Fixing Policies</TITLE>
  <BODY text = "#000000" link="#000fff" vlink="#ff0f0f" bgcolor="#ffffff">

<HR>
<H3>ACE, TAO, CIAO, and DAnCE Bug Fixing Policies</H3>

As <A HREF="http://www.dre.vanderbilt.edu/ACE/">ACE</A>, <A
HREF="http://www.dre.vanderbilt.edu/TAO/">TAO</A>, <A
HREF="http://www.dre.vanderbilt.edu/CIAO/">CIAO</A>, and DAnCE have grown in
popularity the volume of mail on the <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-mail.html">mailing
lists</A> has grown
considerably.  While this increase is healthy, and a natural
consequence of the larger number of ACE, TAO, and CIAO users, it is
straining the resources of the researchers in the <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-members-i.html">DOC
group</A> at <A
HREF="http://www.cs.wustl.edu/~schmidt/doc-center.html">Washington
University</A>, <A HREF="http://zen.uci.edu">UC Irvine</A> and <A
HREF="http://www.dre.vanderbilt.edu">ISIS</A> to respond to all the
traffic immediately.  Prompt bug fixes from the DOC group also
discourage the creation of a larger community of <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-members.html">users</A> and
<A
HREF="http://www.dre.vanderbilt.edu/support.html">commercial
support companies</A> who have deep knowledge of how ACE, TAO, and
CIAO work and can help provide bug fixes and new features. <P>

<HR>
<H3>Process for Reporting a Bug</H3>

To ensure the continued growth and maturation of ACE, TAO, and CIAO,
and to allow the user and vendor communities to evolve, please make it
a point to abide by the following policies:

<UL>

<LI> All bug reports to the <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-mail.html">mailing
lists</A> should be submitted using the appropriate bug report form in
<A HREF="../PROBLEM-REPORT-FORM">$ACE_ROOT/PROBLEM-REPORT-FORM</A>
(for ACE), <A
HREF="../TAO/PROBLEM-REPORT-FORM">$TAO_ROOT/PROBLEM-REPORT-FORM</A>
(for TAO), <A
HREF="../TAO/CIAO/PROBLEM-REPORT-FORM">$CIAO_ROOT/PROBLEM-REPORT-FORM</A>
(for CIAO), <A
HREF="../TAO/DAnCE/PROBLEM-REPORT-FORM">$DAnCE_ROOT/PROBLEM-REPORT-FORM</A>
(for DAnCE).  Please use these forms since bug reports that are not
submitted in this form are likely to fall through the cracks.  Here is
our policy for addressing these bug reports: <P>

<OL>

<LI> If a report is from someone <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-sponsors.html">sponsoring</A>
our work we will respond to it in a very timely manner.  Please
contact <A HREF="mailto:schmidt@dre.vanderbilt.edu">me</A> if you'd
like to become a sponsor. <P>

<LI> If it's a bug report that pertains to the latest release and it
also contains a fix we will try to apply this in a timely manner.  In
general, people who submit good bug reports with fixes tend to get
much better help from the core DOC group team, irrespective of whether
they are sponsors or not since they are helping our overall effort
move ahead. <P>

<LI> If it's a bug report for the latest release that prevents ACE,
TAO, or CIAO from working on a popular platform used by ourselves or
our sponsors we'll try to fix it as time permits. <P>

</OL>

<LI> You should also consider entering your bug report into a <A
HREF="https://github.com/DOCGroup/ACE_TAO">github </A> issue
so that it's archived for future processing.  As usual,
we try to address these bugs as time permits, but may not get to them
for a while unless it affects our work or the work of our
sponsors. <P>

We encourage bug reports for those without support to be posted
initially to the <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-mail.html">ACE users</A>
(<A HREF="mailto:ace-users@list.isis.vanderbilt.edu">ace-users@list.isis.vanderbilt.edu</A>),
<A HREF="http://www.dre.vanderbilt.edu/~schmidt/TAO-mail.html">TAO users</A>
(<A HREF="mailto:tao-users@list.isis.vanderbilt.edu">tao-users@list.isis.vanderbilt.edu</A>),
and <A HREF="http://www.dre.vanderbilt.edu/~schmidt/TAO-mail.html">CIAO
users</A> (<A
HREF="mailto:ciao-users@list.isis.vanderbilt.edu">ciao-users@list.isis.vanderbilt.edu</A>)
mailing lists, where the open-source user community may already have
developed, or have an interest in developing, a solution.  <P>

<LI> While the core DOC group development team participates in this
mailing list, we cannot response to all postings.  Therefore, if you
post something and don't get a reply, please do the following:<P>

<UL>
<LI>
 Check to see whether your posting made it to the list through the list archives, which you
  can see by checking out the <A
    HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-mail.html">list archive</A> to see if your posting is visible. <P>

<LI> If it's not visible, please make sure you're
  <A HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-mail.html">subscribed
to the mailing
  list(s)</A> you sent the report to since we have a "members only" posting
  requirement to minimize spam. <P>

<LI> If it is visible and you haven't received a reply this probably means
  that either no one knows the answer or no one has time to answer it.
  As always, if you need more predictable help please contact one of
  <A
HREF="http://www.dre.vanderbilt.edu/support.html">commercial
support</a> companies for ACE+TAO.<P>

</UL>

<LI> If you find a problem with a version of TAO that was released by
    <A HREF="http://www.theaceorb.com/">OCI</A> then please report it
    to <A
    HREF="mailto:taosupport@ociweb.com">taosupport@ociweb.com</A>.
    Likewise, if you find a problem with a version of TAO that was released by
    <A HREF="http://www.microfocus.com">Micro Focus</A> then please
    report it to MicroFocus.
    Their versions of TAO are different from the DOC group's
    version of TAO and thus they provide their own support. <P>

<LI> If it's a general question about how to use ACE, TAO, or CIAO
feature we'll try to respond as time permits, though we will also rely
on the experience of the open-source user community to field these
types of questions, as well.  You should first check out the <A
HREf="http://www.theaceorb.com/faq/">online FAQ</A> to see if your
question has already been answered.  If you require consulting support
for ACE, TAO, or CIAO, please contact one of the companies that
provides <A
HREF="http://www.dre.vanderbilt.edu/support.html">commercial
support</A>.<P>

</UL>

<HR>
<H3>Process for Submitting a Bug Fix</H3>

We encourage other ACE, TAO, and CIAO users to continue to help
provide fixes and advice in response to postings on the mailing lists
and newsgroup.  If you have a patch that fixes a problem you've found
with our software here's the process for submitting it:

<OL>
<LI> Use the latest contents of git repository, i.e.,
     what's available from <P>

  <A HREF="https://github.com/DOCGroup/ACE_TAO">https://github.com/DOCGroup/ACE_TAO</A> <P>

<LI> Create a fork of the ATCD repository and prepare your fixes including documentation
     changes and automated unit tests. For any change in ACE create (or augment) a test program
     that validates your patch and integrate it into the  <A HREF="../tests">ACE_ROOT/tests</A>
     directory. Clearly document each commit because that information
     will end up in the ATCD ChangeLog. When you have tested your changes at least on Windows
     and Linux prepare a <a href="https://help.github.com/articles/using-pull-requests/">pull request</a>.<P>

<LI> Create a ``unified diff'' of all changes and put this into a github issue at <P>

  <A HREF="https://github.com/DOCGroup/ACE_TAO">https://github.com/DOCGroup/ACE_TAO</A> <P>

  and send an email to the appropriate <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE-mail.html">mailing
list(s)</A> summarizing what the problem was and you've done to fix the
problem. <P>

<LI> If your patch is for a platform/compiler that aren't part of our
<A HREF="http://www.dre.vanderbilt.edu/scoreboard">autobuild
scoreboard</A> please consider contributing one or more autobuilds
that can be used to keep track of changes to your platform/compiler
combination and ensure things continue to work as the ACE+TAO source
code evolves. <P>

<LI> By submitting bug fixes submitters acknowledge that they have the
right to do so, that any such submissions are given freely and
unreservedly, and that they waive any claims to copyright or
ownership.  In addition, submitters acknowledge that any such
submission might become part of the copyright maintained on the
overall body of code that comprises the DOC software.  By making a bug
fix submission, submitter agree to these terms.  Moreover, submitters
acknowledge that the incorporation or modification of such submissions
is entirely at the discretion of the moderators of the open-source DOC
software projects or their designees. <P>

</OL>

Please be sensitive to the fact that the core <A
HREF="http://www.dre.vanderbilt.edu/">DOC group</A> team is
<EM>very</EM> busy, so we often don't have time to address problems
reported by non-sponsors.  If you'd like an immediate response, please
contact <A HREF="mailto:schmidt@dre.vanderbilt.edu">me</A> about
becoming a sponsor or contact one of the companies that provides <A
HREF="http://www.dre.vanderbilt.edu/support.html">
commercial support</A> for ACE, TAO, and CIAO. <P>

<HR><P>
Back to the <A
HREF="http://www.dre.vanderbilt.edu/~schmidt/ACE.html">ACE</A> page.<BR>
Back to <A HREF="index.html">ACE Documentation Home</A>.

<!--#include virtual="/~schmidt/cgi-sig.html" -->
</BODY>
</HTML>