Changes between Version 1 and Version 2 of WikiStart/Standards/RG11


Ignore:
Timestamp:
02/17/15 18:02:39 (4 years ago)
Author:
sylvain.joyeux
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart/Standards/RG11

    v1 v2  
    1 = Backward compatibility in Rock Core = 
     1= Deprecation process in Rock Core = 
     2 
     3== Code == 
    24 
    35Backward compatibility should not be dropped from packages in rock-core without advance warning. 
     
    68 
    79 - relevant deprecation warnings must be displayed either at compilation or runtime. The warnings should be present for at least one Rock release cycle, and the deprecation should be noted in the release notes. 
    8  - deprecated code should be kept but disabled for at least one additional release cycle. By "disabled", it is meant that the package's user should have a way to reenable/reuse the code should he decide to do so (as opposed to update its own code) 
    9  - after these two "grace" cycles, the code can be removed at the discretion of the package maintainer. 
     10 - deprecated code should be kept but disabled for at least one additional release cycle. By "disabled", it is meant that the package's user should have a way to reenable/reuse the code should he decide to do so (as opposed to update its own code). The release notes should mention this. 
     11 - after these two "grace" cycles, the code can be removed at the discretion of the package maintainer. The release notes should mention this. 
     12 
     13== Packages == 
     14 
     15'''NOTE''' As of 02/2015, this process requires additional features from autoproj (deprecated_package, un-exclusion of packages by adding them to the layout) 
     16 
     17Deprecated packages is marked as excluded in the autobuild files using the deprecated_package helper. This helper excludes the package, and adds an  exclusion message that mentions deprecation. If the package is deprecated because it is in need of a maintainer, the helper's caller can provide an extra message that mentions it, and how to become the package's maintainer. 
     18 
     19Packages excluded this way can be re-added to the build by explicitly mentioning them in the layout. The exclusion message makes this explicit.  
     20 
     21Releases that add deprecation should mention it in their release notes.  
     22 
     23The package can be removed after a full release cycle. The release notes must mention it.