Add links for common queries.
[scons.git] / www / feature-request.html
1 <html>
2 <head>
3 <title>Feature Requests</title>
4 </head>
5 <body>
6
7 <div id="apphead">
8 <h1><small>scons</small><br />Feature Requests</h1>
9 </div>
10
11 <p>
12 <strong>If you have not already done so, please
13 <a href="http://www.tigris.org/servlets/Login">log in</a>
14 before submitting a feature request!</strong>
15 </p>
16
17 <p>
18 Feature requests should be submitted to the
19 <a href="http://scons.tigris.org/issues/enter_bug.cgi?subcomponent=scons&issue_type=FEATURE">"Enter Issue" page</a>.
20 A more detailed set of <a href="feature-request.html#steps">submission steps</a>
21 can be found below.
22 </p>
23
24 <p>
25 The "Enter Issue" links on this page,
26 by default, create a <tt>FEATURE</tt> request,
27 a request for completely new SCons functionality.
28 If your request is for modified behavior
29 of an already-existing SCons feature,
30 you may wish to change the Issue type
31 to an <tt>ENHANCEMENT</tt> request.
32 If you're not sure, leave the issue as a <tt>FEATURE</tt> request;
33 it can be reclassified in the future, if necessary.
34 </div>
35
36 <div class="h2 app" style="border-left: 0px" id="customcontent">
37
38 <h2 id="steps">Steps for Submitting a Feature Request</h2>
39
40 <p>
41 The following guides you step-by-step through the
42 process of submitting a feature request.
43 </p>
44
45 <ul>
46 <li>
47 <strong><a href="http://www.tigris.org/servlets/Login">Log in</a> at tigris.org</strong>
48 <p>
49 If you do not already have a tigris.org account,
50 you can register for one at
51 <a href="http://www.tigris.org/servlets/Join">http://www.tigris.org/servlets/Join</a>.
52 </p>
53 <p>
54 You can still submit a feature request anonymously, without logging in.
55 If you choose not to create a tigris.org account,
56 putting some identifying contact information
57 in the description will be helpful in case
58 the feature request requires some clarification.
59 </p>
60 </li>
61 <li>
62 <strong>Go to the
63 <a href="http://scons.tigris.org/issues/enter_bug.cgi?subcomponent=scons&issue_type=FEATURE">"Enter issue" page</a>
64 </strong>
65 <p>
66 By default, the "scons" subcomponent is selected;
67 if this bug is for a different subcomponent, select that instead.
68 </p>
69 </li>
70 <li>
71 <strong>Fill in a good Summary line describing the feature you're requesting</strong>
72 <p>
73 This line is what shows up in summary reports,
74 so it should be descriptive but not too long.
75 </p>
76 </li>
77 <li>
78 <strong>Fill in the Description field</strong>
79 <p>
80 This is where you should go into detail
81 about what you'd like to see SCons do differently.
82 When in doubt, include more information rather than less.
83 </p>
84 </li>
85 <li>
86 <strong>Press the "Submit issue" to submit your request</strong>
87 <p>
88 You will now receive a <tt>Posting issue</tt> page
89 that gives you the number of the issue you submitted.
90 If you want to attach a file to your feature request,
91 you can do so by clicking the
92 <tt>Attach a file to this issue</tt>
93 link and using that page to upload a file.
94 </p>
95 </li>
96 </ul>
97
98 </div>
99
100 </body>
101 </html>