http://wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&feed=atom&action=historySpec Template - Revision history2024-03-29T11:22:39ZRevision history for this page on the wikiMediaWiki 1.23.0//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=12045&oldid=prevKaberett: added needs-update flag2014-08-01T13:23:10Z<p>added needs-update flag</p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 13:23, 1 August 2014</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">{{Update}} Bugzilla is dead.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>{{Design Links}} To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you've done that, the basic format for the spec should look like this.  </div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>{{Design Links}} To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you've done that, the basic format for the spec should look like this.  </div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
</table>Kaberett//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=9747&oldid=prevAzureLunaticDW: /* Other Sections (as applicable) */ Site is launched; adjusting accordingly2011-05-01T03:15:31Z<p><span dir="auto"><span class="autocomment">Other Sections (as applicable): </span> Site is launched; adjusting accordingly</span></p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 03:15, 1 May 2011</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 57:</td>
<td colspan="2" class="diff-lineno">Line 57:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>----</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>----</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>If you run into questions at any point, want to get opinions from other people, want some more background on the history or motivation of what a project's intended to do, or want an explanation of what a Bugzilla project ticket's shorthand description entails (since Denise tends to the extreme shorthand when writing these things up in Bugzilla tickets), feel free to bring <del class="diffchange diffchange-inline">discussion </del>to the <del class="diffchange diffchange-inline">dw-discuss mailing list</del>. <del class="diffchange diffchange-inline">(After launch, we'll have an </del>on-site area for discussion of <del class="diffchange diffchange-inline">these things, but for now, the mailing list will do</del>.<del class="diffchange diffchange-inline">)</del></div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>If you run into questions at any point, want to get opinions from other people, want some more background on the history or motivation of what a project's intended to do, or want an explanation of what a Bugzilla project ticket's shorthand description entails (since Denise tends to the extreme shorthand when writing these things up in Bugzilla tickets), feel free to <ins class="diffchange diffchange-inline">comment on the bug or otherwise </ins>bring <ins class="diffchange diffchange-inline">it </ins>to <ins class="diffchange diffchange-inline">people's attention. <dwcomm>dw_suggestions</dwcomm> fills some of </ins>the <ins class="diffchange diffchange-inline">need for discussing specifications as well</ins>. <ins class="diffchange diffchange-inline">To-do: inquire after the planned </ins>on-site area for discussion of <ins class="diffchange diffchange-inline">specs</ins>.  </div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket. When you upload it, set the "signoff" flag on the attachment to "?", indicating that you're looking for project signoff. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket. When you upload it, set the "signoff" flag on the attachment to "?", indicating that you're looking for project signoff. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>[[Category: Design]]</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>[[Category: Design]]</div></td></tr>
</table>AzureLunaticDW//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=8133&oldid=prevRahaeli: correct my own fail from a year ago2010-04-02T05:45:16Z<p>correct my own fail from a year ago</p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 05:45, 2 April 2010</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 34:</td>
<td colspan="2" class="diff-lineno">Line 34:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>The exact breakdown of what the project should consist of. This should be done in bullet points or short paragraphs, broken down into four categories:</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>The exact breakdown of what the project should consist of. This should be done in bullet points or short paragraphs, broken down into four categories:</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* '''Must''': These are the things that the project must include. Without these elements, the project will be <del class="diffchange diffchange-inline">crippled </del>or useless, and shouldn't be released, even in a beta/testing version.  </div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* '''Must''': These are the things that the project must include. Without these elements, the project will be <ins class="diffchange diffchange-inline">limited </ins>or useless, and shouldn't be released, even in a beta/testing version.  </div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* '''Should''': These are the things that should be included before the project can be considered reasonably complete; with these included, the project can be considered "done" in its initial iteration, and can be provided to the userbase at large with reasonable expectation that 80% or so of people will find it at least a minimal enhancement to their use of the site.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* '''Should''': These are the things that should be included before the project can be considered reasonably complete; with these included, the project can be considered "done" in its initial iteration, and can be provided to the userbase at large with reasonable expectation that 80% or so of people will find it at least a minimal enhancement to their use of the site.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* '''Could''': These are the things that aren't necessary for the project to be considered complete, but which would be useful extensions to the core functionality of the project. Launching the feature/change without these items included wouldn't be a major loss, and many of them may wind up being deferred as future enhancements, but if they're easy and cheap to implement, the engineer working on them should try to fit them in (within time constraints). They should mostly be enhancements or refinements of the "must"s and "should"s, and should connect to those in some way, rather than being completely new sections or subsets of the feature.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* '''Could''': These are the things that aren't necessary for the project to be considered complete, but which would be useful extensions to the core functionality of the project. Launching the feature/change without these items included wouldn't be a major loss, and many of them may wind up being deferred as future enhancements, but if they're easy and cheap to implement, the engineer working on them should try to fit them in (within time constraints). They should mostly be enhancements or refinements of the "must"s and "should"s, and should connect to those in some way, rather than being completely new sections or subsets of the feature.</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* '''Would Be Nice''': The "I want a sparkly pony" section of the spec, containing everything that would be totally awesome with awesomesauce to have, but isn't in any way necessary. These are generally second-level enhancements, major functionality on top of the major functionality changes already listed, things that are intended to make the feature more usable or more desireable to very narrow subsets of specific use cases that aren't very common, or things that go well above and beyond the scope of the spec and are included mostly for completeness. There should be no expectation that the engineer implementing the spec will get to any of the items on this list, much less all, for the initial implementation, but again, if they're easy and cheap, they might make it in.  </div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* '''Would Be Nice''': The "I want a sparkly pony" section of the spec, containing everything that would be totally awesome with awesomesauce to have, but isn't in any way necessary. These are generally second-level enhancements, major functionality on top of the major functionality changes already listed, things that are intended to make the feature more usable or more desireable to very narrow subsets of specific use cases that aren't very common, or things that go well above and beyond the scope of the spec and are included mostly for completeness. There should be no expectation that the engineer implementing the spec will get to any of the items on this list, much less all, for the initial implementation, but again, if they're easy and cheap, they might make it in.</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div> </div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>== Potential Problems ==</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>== Potential Problems ==</div></td></tr>
</table>Rahaeli//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=583&oldid=prevRahaeli at 07:31, 9 January 20092009-01-09T07:31:19Z<p></p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 07:31, 9 January 2009</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 60:</td>
<td colspan="2" class="diff-lineno">Line 60:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>If you run into questions at any point, want to get opinions from other people, want some more background on the history or motivation of what a project's intended to do, or want an explanation of what a Bugzilla project ticket's shorthand description entails (since Denise tends to the extreme shorthand when writing these things up in Bugzilla tickets), feel free to bring discussion to the dw-discuss mailing list. (After launch, we'll have an on-site area for discussion of these things, but for now, the mailing list will do.)</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>If you run into questions at any point, want to get opinions from other people, want some more background on the history or motivation of what a project's intended to do, or want an explanation of what a Bugzilla project ticket's shorthand description entails (since Denise tends to the extreme shorthand when writing these things up in Bugzilla tickets), feel free to bring discussion to the dw-discuss mailing list. (After launch, we'll have an on-site area for discussion of these things, but for now, the mailing list will do.)</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket<ins class="diffchange diffchange-inline">. When you upload it, set the "signoff" flag on the attachment to "?", indicating that you're looking for project signoff</ins>. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>[[Category: Design]]</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>[[Category: Design]]</div></td></tr>
</table>Rahaeli//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=283&oldid=prevFoxfirefey at 19:25, 6 August 20082008-08-06T19:25:33Z<p></p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 19:25, 6 August 2008</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you've done that, the basic format for the spec should look like this.  </div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">{{Design Links}} </ins>To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you've done that, the basic format for the spec should look like this.  </div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Each individual project may have different requirements for its spec; for some projects, there are special considerations that should be highlighted separately, for instance, or some of these sections might not apply to certain projects. Use your best judgement.  </div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Each individual project may have different requirements for its spec; for some projects, there are special considerations that should be highlighted separately, for instance, or some of these sections might not apply to certain projects. Use your best judgement.  </div></td></tr>
</table>Foxfirefey//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=280&oldid=prevFoxfirefey at 19:14, 6 August 20082008-08-06T19:14:36Z<p></p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 19:14, 6 August 2008</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 61:</td>
<td colspan="2" class="diff-lineno">Line 61:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">[[Category: Design]]</ins></div></td></tr>
</table>Foxfirefey//wiki.dreamwidth.net/wiki/index.php?title=Spec_Template&diff=278&oldid=prevRahaeli: New page: To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you...2008-08-06T19:13:46Z<p>New page: To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you...</p>
<p><b>New page</b></p><div>To claim a project that needs specs written, enter your Bugzilla email address on the ticket, next to the "needs-spec:?" flag. This will let others know that you're working on it. Once you've done that, the basic format for the spec should look like this. <br />
<br />
Each individual project may have different requirements for its spec; for some projects, there are special considerations that should be highlighted separately, for instance, or some of these sections might not apply to certain projects. Use your best judgement. <br />
<br />
<br />
== Title of Project ==<br />
<br />
The spec should begin with the title of the project: a few-word description of what the project is intended to do. This can either be taken from the Bugzilla task that created the project, or (if you're working on a spec for a project that hasn't made it into Bugzilla yet, or the Bugzilla task subject line is unwieldy) something you make up. Bonus points for coming up with a snappy title (though the snappy title should ideally also convey what the project's about, so nothing like "Project Heliotrope" or whatever): for instance, "Splitting "Friend" into "Watch" vs. "Trust" becomes "Project WTF", for "Watch/Trust/Friend". <br />
<br />
== Goal ==<br />
<br />
The one-or-two sentence summary: why we think it should be done, and what it will look like when it's finished, in as brief and succinct a fashion as possible.<br />
<br />
== Background ==<br />
<br />
The detailed analysis of the problem that the project is attempting to solve, and/or a complete list of motivations, rationale, and any supporting arguments necessary. This can be anything from a few lines to a page or two, and it should be enough information for someone who doesn't follow development discussion to be able to reasonably understand what the project covers, why we want to do it, why we think it's important, what factors we're taking into consideration, etc.<br />
<br />
Generally, this will be weighted more towards end-user reasons (ie, the benefit it will have to the end user and to the service/to the codebase as a whole). For projects that are mostly backend, however, it may be more technical. Still, ideally this section will be understandable by the majority of the people who read it, with little to no specialized knowledge necessary.<br />
<br />
== Skillsets ==<br />
<br />
The necessary skillsets that fully completing the project will require; will probably be several of the following (or others as applicable):<br />
* Backend engineering<br />
* Frontend engineering<br />
* Human interface design<br />
* Graphic design<br />
* Scalability architecting<br />
* Business design <br />
<br />
If you don't know how to evaluate what components a project will require, don't worry; leave this section blank, and someone will fill it in for you as the spec goes through further iteration and breakdown.<br />
<br />
== Requirements ==<br />
<br />
The exact breakdown of what the project should consist of. This should be done in bullet points or short paragraphs, broken down into four categories:<br />
<br />
* '''Must''': These are the things that the project must include. Without these elements, the project will be crippled or useless, and shouldn't be released, even in a beta/testing version. <br />
* '''Should''': These are the things that should be included before the project can be considered reasonably complete; with these included, the project can be considered "done" in its initial iteration, and can be provided to the userbase at large with reasonable expectation that 80% or so of people will find it at least a minimal enhancement to their use of the site.<br />
* '''Could''': These are the things that aren't necessary for the project to be considered complete, but which would be useful extensions to the core functionality of the project. Launching the feature/change without these items included wouldn't be a major loss, and many of them may wind up being deferred as future enhancements, but if they're easy and cheap to implement, the engineer working on them should try to fit them in (within time constraints). They should mostly be enhancements or refinements of the "must"s and "should"s, and should connect to those in some way, rather than being completely new sections or subsets of the feature.<br />
* '''Would Be Nice''': The "I want a sparkly pony" section of the spec, containing everything that would be totally awesome with awesomesauce to have, but isn't in any way necessary. These are generally second-level enhancements, major functionality on top of the major functionality changes already listed, things that are intended to make the feature more usable or more desireable to very narrow subsets of specific use cases that aren't very common, or things that go well above and beyond the scope of the spec and are included mostly for completeness. There should be no expectation that the engineer implementing the spec will get to any of the items on this list, much less all, for the initial implementation, but again, if they're easy and cheap, they might make it in. <br />
<br />
<br />
== Potential Problems ==<br />
<br />
Things to keep in mind when implementing the spec: <br />
* potential social complications that should be kept in the forefront of the mind when making implementation choices<br />
* any human interaction troublespots (things that people might find hard to use, non-intuitive, etc)<br />
* aspects of the project or feature that might upset people or break certain site-usage patterns and ideas for how to implement the feature without tripping those concerns<br />
* any potential technical issues that should be considered when implementing <br />
* anything else (technical, design, or social) that you think the engineer should consider<br />
<br />
Again, if you don't have the technical experience with the DW codebase necessary to know what the potential technical issues might be, don't sweat it; you can leave those bits out of the spec. (We'd rather you did, in fact, instead of guessing.) Still, if you can think of anything that might be a problem down the road, technical or social, this is where you can put it.<br />
<br />
<br />
== Other Sections (as applicable) ==<br />
<br />
The spot for any project-specific elements that don't fit anywhere else in the spec. <br />
<br />
----<br />
<br />
If you run into questions at any point, want to get opinions from other people, want some more background on the history or motivation of what a project's intended to do, or want an explanation of what a Bugzilla project ticket's shorthand description entails (since Denise tends to the extreme shorthand when writing these things up in Bugzilla tickets), feel free to bring discussion to the dw-discuss mailing list. (After launch, we'll have an on-site area for discussion of these things, but for now, the mailing list will do.)<br />
<br />
Once you have the spec to a point where you think it's ready for review by a DW site admin, upload the spec as an attachment to the Bugzilla ticket. A project admin will review your spec, make suggestions, work with you to make enhancements, and eventually accept the spec.</div>Rahaeli