Left: | ||
Right: |
OLD | NEW |
---|---|
1 Elu@c -*- coding: utf-8; mode: texinfo; -*- | 1 Elu@c -*- coding: utf-8; mode: texinfo; -*- |
2 @node Issues | 2 @node Issues |
3 @chapter Issues | 3 @chapter Issues |
4 | 4 |
5 This chapter deals with defects, feature requests, and | 5 This chapter deals with defects, feature requests, and |
6 miscellaneous development tasks. | 6 miscellaneous development tasks. |
7 | 7 |
8 @menu | 8 @menu |
9 * Introduction to issues:: | 9 * Introduction to issues:: |
10 * The Bug Squad:: | 10 * The Bug Squad:: |
(...skipping 62 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
73 sorting; this can reduce your workload @emph{immensely}. The | 73 sorting; this can reduce your workload @emph{immensely}. The |
74 email folders names were chosen specifically to make them work if | 74 email folders names were chosen specifically to make them work if |
75 you sort your folders alphabetically. | 75 you sort your folders alphabetically. |
76 | 76 |
77 @enumerate | 77 @enumerate |
78 | 78 |
79 @item | 79 @item |
80 Read every section of this chapter, @ref{Issues}. | 80 Read every section of this chapter, @ref{Issues}. |
81 | 81 |
82 @item | 82 @item |
83 If you do not have one already, create a gmail account and send | 83 If you do not have one already, get an email account and send the |
84 the email address to the @ref{Meisters, Bug Meister}. | 84 address to the @ref{Meisters, Bug Meister}. |
85 | 85 |
86 @item | 86 @item |
87 Subscribe your gmail account to @code{bug-lilypond}. | 87 Subscribe your email account to @code{bug-lilypond}. |
88 | 88 |
89 @item | 89 @item |
90 Configure your google code account: | 90 Create your own Sourceforge login (required for the Allura tracker): |
91 | |
92 @enumerate | |
93 | |
94 @item | |
95 Wait until your gmail account is listed in: | |
96 | 91 |
97 @example | 92 @example |
98 @uref{http://code.google.com/p/lilypond/people/list} | 93 @uref{https://sourceforge.net/p/testlilyissues/issues/} |
99 @end example | 94 @end example |
100 | 95 |
101 @item | 96 @item |
102 Sign in to google code by clicking in the top-right corner of: | 97 Click on 'Join' in the top-right corner. |
103 | |
104 @example | |
105 @uref{http://code.google.com/p/lilypond/issues/list} | |
106 @end example | |
107 | |
108 You cannot log on if you have Google Sharing enabled | |
109 @uref{http://www.googlesharing.net/}. | |
110 | 98 |
111 @item | 99 @item |
112 Go to your @qq{Profile}, and select @qq{Settings}. | 100 Fill in your details as required. |
113 | 101 |
114 @item | 102 @item |
115 Scroll down to @qq{Issue change notification}, and make sure that | 103 When this account has been created, send your email address to |
116 you have @emph{selected} @qq{If I starred the issue}. | 104 @email{lilypond-devel@@gnu.org} asking to be given the appropriate |
117 | 105 permissions to create and edit tracker issues. |
Trevor Daniels
2016/03/19 16:50:08
It's not the email address we need but the SourgeF
pkx166h
2016/03/26 15:44:20
Done - with a minor addition.
| |
118 @end enumerate | |
119 | 106 |
120 @item | 107 @item |
121 Configure your email client: | 108 Any email sent with your address in the @code{To:} or |
Trevor Daniels
2016/03/19 16:50:08
I think we need to keep this item and the followin
pkx166h
2016/03/26 15:44:20
Yes I see. I took some more time to look over this
| |
122 | |
123 @enumerate | |
124 | |
125 @item | |
126 Any email sent with your gmail address in the @code{To:} or | |
127 @code{CC:} fields should go to a @code{bug-answers} folder. | 109 @code{CC:} fields should go to a @code{bug-answers} folder. |
128 | 110 |
129 When setting up your filtering rules, be aware that Google Code | |
130 might use different versions of your email address, such as ones | |
131 ending in @code{@@googlemail.com} or @code{@@gmail.com}. | |
132 | |
133 @item | 111 @item |
134 Any other email either from, or CC'd to, | 112 Any other email either from, or CC'd to, |
135 | 113 |
136 @example | 114 @example |
137 lilypond@@googlecode.com | 115 testlilyissues-auto@@lists.sourceforge.net |
138 @end example | 116 @end example |
139 | 117 |
140 @noindent | 118 @noindent |
141 should go into a separate @code{bug-ignore} folder. Alternately, | 119 should go into a separate @code{bug-ignore} folder. Alternately, |
142 you may automatically delete these emails. | 120 you may automatically delete these emails. |
143 | 121 |
144 You will @strong{not read} these emails as part of your Bug Squad | 122 You do @strong{not} need to read these emails. If you are curious, |
145 duties. If you are curious, go ahead and read them later, but it | 123 go ahead and read them later, but it not necessary for Bug Squad work. |
146 does @strong{not} count as Bug Squad work. | |
147 | 124 |
148 @item | 125 @item |
149 Any other email sent to (or CC'd to): | 126 Any other email sent to (or CC'd to): |
150 | 127 |
151 @example | 128 @example |
152 bug-lilypond | 129 bug-lilypond |
153 @end example | 130 @end example |
154 | 131 |
155 @noindent | 132 @noindent |
156 should go into a separate @code{bug-current} folder. | 133 should go into a separate @code{bug-current} folder. |
157 | 134 |
158 @end enumerate | 135 @end enumerate |
159 | 136 |
160 @end enumerate | |
161 | |
162 | 137 |
163 @node Bug Squad checklists | 138 @node Bug Squad checklists |
164 @subsection Bug Squad checklists | 139 @subsection Bug Squad checklists |
165 | 140 |
166 When you do Bug Squad work, start at the top of this page and work | 141 When you do Bug Squad work, start at the top of this page and work |
167 your way down. Stop when you've done 20 minutes. | 142 your way down. Stop when you've done 20 minutes. |
168 | 143 |
169 Please use the email sorting described in @ref{Bug Squad setup}. | 144 Please use the email sorting described in @ref{Bug Squad setup}. |
170 This means that (as Bug Squad members) you will only ever respond | 145 This means that (as Bug Squad members) you will only ever respond |
171 to emails sent or CC'd to the @code{bug-lilypond} mailing list. | 146 to emails sent or CC'd to the @code{bug-lilypond} mailing list. |
172 | 147 |
173 | 148 |
174 @subsubheading Emails to you personally | 149 @subsubheading Emails to you personally |
175 | 150 |
176 You are not expected to work on Bug Squad matters outside of your | 151 You are not expected to work on Bug Squad matters outside of your |
177 20 minutes, but sometimes a confused user will send a bug report | 152 20 minutes, but sometimes a confused user will send a bug report |
178 (or an update to a report) to you personally. If that happens, | 153 (or an update to a report) to you personally. If that happens, |
179 please forward such emails to the @code{bug-lilypond} list so that | 154 please forward such emails to the @code{bug-lilypond} list so that |
180 the currently-active Bug Squad member(s) can handle the message. | 155 the currently-active Bug Squad member(s) can handle the message. |
181 | 156 |
182 | 157 |
183 @subsubheading Daily schedule as of July 2015 | 158 @subsubheading Daily schedule as of July 2015 |
184 | 159 |
185 @example | 160 @example |
186 Monday: Federico Bruni | 161 Monday: Federico Bruni |
187 Tuesday: Simon Albrecht | 162 Tuesday: Simon Albrecht |
188 Wednesday: Simon Albrecht | 163 Wednesday: Simon Albrecht |
189 Thursday: Colin Campbell | 164 Thursday: Colin Campbell |
190 Friday: | 165 Friday: Ralph Palmer |
191 Saturday: Colin Campbell | 166 Saturday: Colin Campbell |
192 Sunday: | 167 Sunday: |
193 @end example | 168 @end example |
194 | 169 |
195 | 170 |
196 @subsubheading Emails to @code{bug-answers} | 171 @subsubheading Emails to @code{bug-answers} |
197 | 172 |
198 Some of these emails will be comments on issues that you added to | 173 Some of these emails will be comments on issues that you added to |
199 the tracker. | 174 the tracker. |
200 | 175 |
(...skipping 133 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
334 | 309 |
335 @subheading Regular maintenance | 310 @subheading Regular maintenance |
336 | 311 |
337 After @strong{every release} (both stable and unstable): | 312 After @strong{every release} (both stable and unstable): |
338 | 313 |
339 @itemize | 314 @itemize |
340 | 315 |
341 @item | 316 @item |
342 Issues to verify: go to | 317 Issues to verify: go to |
343 | 318 |
319 @smallexample | |
320 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status%3AFixed} | |
321 @end smallexample | |
322 | |
323 (You can also generate this list by selecting the @qq{Open (Fixed)} | |
324 button down the left-hand frame) | |
325 | |
326 You should see a list of Issues that have been marked as 'Fixed' by a | |
327 developer. If the developer has done their job properly, the | |
328 Issue should have the @qq{Labels} field filled in with @qq{Fixed_x_y_z}, | |
329 where X is the major version, y the minor version and z the current | |
330 release. | |
331 | |
344 @example | 332 @example |
345 @uref{http://code.google.com/p/lilypond/issues/list?can=7} | 333 Fixed_2_19_39 |
346 @end example | 334 @end example |
347 | 335 |
348 (You can also generate this list by selecting | 336 This will help you work out which you can verify - do not verify any |
349 @qq{Issues to verify} from the drop-down list next to the search | 337 Issues where the claimed fixed build is not yet released. Work your |
350 box.) | 338 way through these as follows: |
351 | |
352 You should see a list of Issues that have been claimed fixed by a | |
353 developer. If the developer has done their job properly, the | |
354 Issue should have a tag @qq{Fixed_mm_MM_ss}, where mm is | |
355 the major version, MM the minor version and ss the current | |
356 release. This will help you work out which you can verify - do | |
357 not verify any Issues where the claimed fixed build is not yet | |
358 released. Work your way through these as follows: | |
359 | 339 |
360 If the Issue refers to a bug, try to reproduce the bug with the latest | 340 If the Issue refers to a bug, try to reproduce the bug with the latest |
361 officially released version (not one you've built yourself from | 341 officially released version (not one you've built yourself from |
362 source); if the bug is no longer there, mark the | 342 source); if the bug is no longer there, mark the |
363 issue @qq{Verified} (i.e. @qq{the fix has been verified to work}). | 343 issue @qq{Verified} (i.e. @qq{the fix has been verified to work}). |
364 | 344 |
365 Quite a few of these will be issues tracking patches. @strong{You | 345 Quite a few of these will be issues tracking patches. @strong{You |
366 do not have to prove these patches work - simply that they have | 346 do not have to prove these patches work - simply that they have |
367 been pushed into the code base.} The developer should have put | 347 been pushed into the code base.} The developer should have put |
368 information similar to @qq{Pushed as as | 348 information similar to @qq{Pushed as as |
(...skipping 662 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
1031 | 1011 |
1032 @item | 1012 @item |
1033 downgrade patches from @code{Patch-review} to | 1013 downgrade patches from @code{Patch-review} to |
1034 @code{Patch-needs_work} as appropriate. | 1014 @code{Patch-needs_work} as appropriate. |
1035 | 1015 |
1036 @item | 1016 @item |
1037 downgrade patches from @code{Patch-needs_work} to | 1017 downgrade patches from @code{Patch-needs_work} to |
1038 @code{Patch-abandoned} if no actions have been taken in four | 1018 @code{Patch-abandoned} if no actions have been taken in four |
1039 weeks. | 1019 weeks. |
1040 | 1020 |
1041 @end itemize | 1021 @end itemize |
Trevor Daniels
2016/03/26 23:09:37
This is a large section to simply delete. I reali
pkx166h
2016/03/27 11:39:55
Hello Trevor,
I am not following you mean.
All
Trevor Daniels
2016/03/28 20:37:37
Hi James
Hhm, this is strange. The large deleted
| |
1042 | 1022 |
1043 @end ignore | 1023 @end ignore |
1044 | 1024 |
1045 | 1025 |
1046 @node Summary of project status | 1026 @node Summary of project status |
1047 @section Summary of project status | 1027 @section Summary of project status |
1048 | 1028 |
1049 @subsubheading Project overview | 1029 @subsubheading Project overview |
1050 | 1030 |
1051 Grid view provides the best overview: | 1031 Project activity |
1052 | 1032 |
1053 @smallexample | 1033 @smallexample |
1054 @uref{http://code.google.com/p/lilypond/issues/list?mode=grid&y=Priority&x=Type& cells=ids} | 1034 @uref{https://sourceforge.net/projects/testlilyissues/} |
1055 @end smallexample | 1035 @end smallexample |
1056 | 1036 |
1057 @subsubheading Hindering development | 1037 @subsubheading Hindering development |
1058 | 1038 |
1059 These issues stop or slow development work: | 1039 These issues stop or slow development work: |
1060 | 1040 |
1061 @smallexample | 1041 @smallexample |
1062 @uref{http://code.google.com/p/lilypond/issues/list?can=2&q=label:Maintainabilit y} | 1042 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status:Accepted% 20AND%20_type:Maintainability} |
1063 @end smallexample | 1043 @end smallexample |
1064 | 1044 |
1065 @subsubheading Easy tasks | 1045 @subsubheading Easy tasks |
1066 | 1046 |
1067 Issues tagged with @code{Frog} indicates a task suitable for a | 1047 Issues tagged with @code{Frog} indicates a task suitable for a |
1068 relatively new contributor. The time given is a quick | 1048 relatively new contributor. The time given is a quick (and probably |
1069 (inaccurate) estimate of the time required for somebody who is | 1049 inaccurate) estimate of the time required for somebody who is familiar |
1070 familiar with material in this manual, but does not know anything | 1050 with material in this manual, but does not know anything else about |
1071 else about LilyPond development. | 1051 LilyPond development. |
1072 | 1052 |
1073 @smallexample | 1053 @smallexample |
1074 @uref{http://code.google.com/p/lilypond/issues/list?can=2&q=label:Frog} | 1054 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status:Accepted% 20AND%20labels:Frog} |
1075 @end smallexample | 1055 @end smallexample |
1076 | 1056 |
1077 @subsubheading Patches to review | 1057 @subsubheading Patches currently in the Patch Review cycle |
1078 | 1058 |
1079 Patches which have no @qq{obvious} problems: | 1059 Overview |
1060 | |
1061 @c The following URL is provided by one of the Developers giving a much | |
1062 @c easier way to see all patches at all stages of the Review cycle in a | |
1063 @c single place. | |
1080 | 1064 |
1081 @example | 1065 @example |
1082 @uref{http://code.google.com/p/lilypond/issues/list?can=2&q=label:patch-review} | 1066 http://philholmes.net/lilypond/allura/ |
1083 @end example | 1067 @end example |
1084 | 1068 |
1085 | 1069 |
1070 @noindent | |
1071 New patches | |
1086 | 1072 |
1073 @smallexample | |
1074 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status%3AStarted +AND+_patch%3Anew} | |
1075 @end smallexample | |
1076 | |
1077 | |
1078 @noindent | |
1079 Patches under Review | |
1080 | |
1081 @smallexample | |
1082 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status%3AStarted +AND+_patch%3Areview} | |
1083 @end smallexample | |
1084 | |
1085 | |
1086 @noindent | |
1087 Patches on final Countdown | |
1088 | |
1089 @smallexample | |
1090 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status%3AStarted +AND+_patch%3Acountdown} | |
1091 @end smallexample | |
1092 | |
1093 | |
1094 @noindent | |
1095 Patches that can be pushed | |
1096 | |
1097 @smallexample | |
1098 @uref{https://sourceforge.net/p/testlilyissues/issues/search/?q=status%3AStarted +AND+_patch%3Apush} | |
1099 @end smallexample | |
OLD | NEW |