History:Checklist For Style Changes: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(CategoryStyleCouncil and status update (Imported from MoinMoin))
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Status|This page is out of date. It is retained solely for historical purposes. Up to date information is found at [[Proposals]].}}
=Checklist for Changes to the Style Guidelines=


This page describes the things that should be checked before a [[Style Change|StyleChange]] is made to the [[Style Guideline|StyleGuideline]]<code><nowiki></nowiki></code>s. It [[Needs Intertwingling|NeedsIntertwingling]], too.
This page describes the things that should be checked before a style change is made to the [[Style Guideline|style guideline]]s.


There was a time when this checklist was rigidly enforced, but this paralyzed the [[Style Council|StyleCouncil]] (see [[History Of The Style Council|HistoryOfTheStyleCouncil]]). This list is still valuable but not to be used as a form that you have to fill out in three exemplaires with attested copies ;-) .
There was a time when this checklist was rigidly enforced, but this paralyzed the [[Style Council|StyleCouncil]] (see [[History Of The Style Council|HistoryOfTheStyleCouncil]]). This list is still valuable but not to be used as a form that you have to fill out in three exemplaires with attested copies ;-) .


==Checklist==
==Checklist==


===How will this affect the data?===
===How will this affect the data?===
Before a style change gets approved, we must have a clear idea of how this will affect the data. This question is difficult to answer, because it involves what people will do with the data by following the new rules or using the new possibilities. However, it is very important to prevent something like the [[S G5 Disaster|SG5Disaster]] from happening again. How will the change affect the way (old and new) data is stored? What is the difference between the way it is stored now and the way it will be stored? How big is the change in [[Soft Structure|SoftStructure]]? It might very well be that the change resolves some oddities but creates problems for cases that were simple unter the old guideline. Concrete questions are:

* Is the change just an addition or or a real change in structure? Do elements get reorganized?
<ul><li style="list-style-type:none">Before a [[Style Change|StyleChange]] gets approved, we must have a clear idea of how this will affect the data. This question is difficult to answer, because it involves what people will do with the data by following the new rules or using the new possibilities. However, it is very important to prevent something like the SG5Disaster from happening again. How will the change affect the way (old and new) data is stored? What is the difference between the way it is stored now and the way it will be stored? How big is the change in [[Soft Structure|SoftStructure]]? It might very well be that the change resolves some oddities but creates problems for cases that were simple unter the old guideline. Concrete questions are:
* How far does the change reach? (e.g. before the [[SG5 Disaster Relief|SG5DisasterRelief]] changing a single [[Track Artist|TrackArtist]] would make an album a [[Various Artists Release|VariousArtistsRelease]], which would move it to another category on the artist page...).
* Is the change just an addition or or a real change in structure? Do elements get reorganized?
* What were the edge cases of the old guideline, and how are these affected?
* How far does the change reach? (e.g. before the [[SG5 Disaster Relief|SG5DisasterRelief]] changing a single [[Track Artist|TrackArtist]] would make an album a [[Various Artists Release|VariousArtistsRelease]], which would move it to another category on the artist page...).
* What were the edge cases of the old guideline, and how are these affected?

</ul>


===Conflicts with other style guidelines===
===Conflicts with other style guidelines===
What is the scope of the affected guideline? Does the style change move the boundaries of this scope? The [[Official Style Guideline|OfficialStyleGuideline]]s form a balanced set. Both extending and reducing the scope of one element can unbalance the whole set.

<ul><li style="list-style-type:none">What is the scope of the affected guideline? Does the [[Style Change|StyleChange]] move the boundaries of this scope? The [[Official Style Guideline|OfficialStyleGuideline]]<code><nowiki></nowiki></code>s form a balanced set. Both extending and reducing the scope of one element can unbalance the whole set.
</ul>


===Required editor time===
===Required editor time===
How much work by editors is required to implement the change? If this is a lot: Can the change be automated, and is this worth it?

<ul><li style="list-style-type:none">How much work by editors is required to implement the change? If this is a lot: Can the change be automated, and is this worth it?
</ul>


===Required developer time===
===Required developer time===
How much work by developers is required to implement the change? Keep in mind that developer time is limited and we wish to avoid wasting their time if at all possible. The person who requests an approval usually gets the responsibility to do the following things:

* Update relevant wiki pages
<ul><li style="list-style-type:none">How much work by developers is required to implement the change? Keep in mind that developer time is limited and we wish to avoid wasting their time if at all possible. The person who requests an approval usually gets the responsibility to do the following things:
* Close the issue in the [[Bug Tracker|BugTracker]]
* Update relevant wiki pages
* Communicate the finished change on the [[Users Mailing List|UsersMailingList]] or the [[Brainz Blog|BrainzBlog]]
* Close the issue in the [[Bug Tracker|BugTracker]]
* Communicate the finished change on the [[Users Mailing List|UsersMailingList]] or the [[Brainz Blog|BrainzBlog]]

</ul>


===Impact on paying clients===
===Impact on paying clients===
Could the change possibly affect paying clients? If so find out if it does. Remember that paying clients do not control ''what'' changes we make, but we think of them regarding ''how'' we roll out changes.


[[Category:History]]
<ul><li style="list-style-type:none">Could the change possibly affect paying clients? If so find out if it does. Remember that paying clients do not control ''what'' changes we make, but we think of them regarding ''how'' we roll out changes.
</ul>

----

The initial list was created by [[User:TarragonAllen|TarragonAllen]].
[[Category:To Be Reviewed]] [[Category:Style]] [[Category:Style Council]]

Latest revision as of 17:06, 8 October 2011

Status: This page is out of date. It is retained solely for historical purposes. Up to date information is found at Proposals.

This page describes the things that should be checked before a style change is made to the style guidelines.

There was a time when this checklist was rigidly enforced, but this paralyzed the StyleCouncil (see HistoryOfTheStyleCouncil). This list is still valuable but not to be used as a form that you have to fill out in three exemplaires with attested copies ;-) .

Checklist

How will this affect the data?

Before a style change gets approved, we must have a clear idea of how this will affect the data. This question is difficult to answer, because it involves what people will do with the data by following the new rules or using the new possibilities. However, it is very important to prevent something like the SG5Disaster from happening again. How will the change affect the way (old and new) data is stored? What is the difference between the way it is stored now and the way it will be stored? How big is the change in SoftStructure? It might very well be that the change resolves some oddities but creates problems for cases that were simple unter the old guideline. Concrete questions are:

  • Is the change just an addition or or a real change in structure? Do elements get reorganized?
  • How far does the change reach? (e.g. before the SG5DisasterRelief changing a single TrackArtist would make an album a VariousArtistsRelease, which would move it to another category on the artist page...).
  • What were the edge cases of the old guideline, and how are these affected?

Conflicts with other style guidelines

What is the scope of the affected guideline? Does the style change move the boundaries of this scope? The OfficialStyleGuidelines form a balanced set. Both extending and reducing the scope of one element can unbalance the whole set.

Required editor time

How much work by editors is required to implement the change? If this is a lot: Can the change be automated, and is this worth it?

Required developer time

How much work by developers is required to implement the change? Keep in mind that developer time is limited and we wish to avoid wasting their time if at all possible. The person who requests an approval usually gets the responsibility to do the following things:

Impact on paying clients

Could the change possibly affect paying clients? If so find out if it does. Remember that paying clients do not control what changes we make, but we think of them regarding how we roll out changes.