Changes between Version 1 and Version 2 of DeprecatingFeatures


Ignore:
Timestamp:
Apr 27, 2012 10:33:43 PM (12 years ago)
Author:
dbates@webkit.org
Comment:

Spelling corrections

Legend:

Unmodified
Added
Removed
Modified
  • DeprecatingFeatures

    v1 v2  
    55 * The burden on the overall project needs to be evaluated as it should be the primary driver for dropping any feature. Small features that require very little maintenance may not qualify under this rule and their deprecation would need to be argued extensively.
    66 * If the feature is used (e.g. MutationEvent), we need to show that we have a replacement that is '''better''' than the feature to be deprecated (better needs to be defined in the context of the deprecation and will need to be argued).
    7  * Deprecating a feature means we will remove it in the future. Deprecation is not meant as a usage metric collection or to assess web-developpers' reactions.
     7 * Deprecating a feature means we will remove it in the future. Deprecation is not meant as a usage metric collection or to assess web-developers' reactions.
    88
    99= Deprecation steps =
    1010
    11  * Any deprecation should be send to webkit-dev for discussion.
     11 * Any deprecation should be sent to webkit-dev for discussion.
    1212 * Any deprecation requires some data as to why the feature can be deprecated. The goal of the data is to show that the feature is not widely used and is not popular. The following would qualify:
    1313  * usage statistics in the wild (either by instrumenting the browser or any other means).
    1414  * some discussions on the standard mailing lists underlining that the standards' bodies don't think there is enough traction to get the feature standardized.
    15   * some proofs that there is others way to achieve the same result that are better.
    16   * some proofs that web-developers don't care much about this feature.
     15  * some proof that there is others way to achieve the same result that are better.
     16  * some proof that web-developers don't care much about this feature.
    1717  * ...
    1818 * If several vendors are supporting the feature, we expect people to have interacted with them to assess their support towards the removal.