Deprecated and removed functionality
Content:
Functionality deprecation and remove policy
At Cygnus NGSI agent (cygnus-ngsi), functionality lifecycle is:
- New feature is designed.
- New feature is implemented and released.
- Existent feature is fixed, when required.
- Existent feature is deprecated if a new feature encloses it or becomes unnecessary.
- Existent feature is definitely removed after certain period of time.
While a feature is deprecated, it is still available at cygnus-ngsi, i.e. it can be used and it is documented. Nevertheless, it is no longer supported nor fixed nor improved. A disclaimer is added in the documentation, and optionally, in the logs.
Deprecated features are removed not before 3 development sprints (usually, a development sprint comprises one month).
This policy will be effective from release 1.6.0 (included). Before that, this policy has been implemented de facto with more or less success.
Deprecated functionalities
NGSIv1 support
Deprecated after releasing version 1.18.0.
Grouping Rules
Added at version 0.5 (issue 107).
Deprecated after releasing version 1.6.0 (issue 1182).
Removed in version 2.20.0
flip_coordinates parameter
Added at version 1.0.0 (issue 927).
Deprecated after releasing version 1.6.0 (issue 1313).
Removed functionalities
events_ttl parameter
Added at version 0.1.
Never deprecated.
Removed in favor of batch_ttl parameter after releasing version 0.13.0 (issue 714).
XML notifications support
Added at version 0.1.
Deprecated in favor of Json notifications from the very beginning of the development.
Removed after releasing version 0.13.0 (issue 448).
cosmos_-like HDFS parameters
Added at version 0.1.
Deprecated in favor of hdfs_-like parameters after releasing version 0.8.1 (issue 374).
Removed after releasing version 1.0.0 (issue 868).
Data model by attribute in NGSICartoDBSink
Added at version 1.0.0 (issue 927).
Never deprecated.
Removed after releasing version 1.1.0 (issue 1030).
matching_table parameter
Added at version 0.5 (issue https://github.com/telefonicaid/fiware-cygnus/issues/107).
Deprecated in favor of grouping_rules_conf_file after releasing version 0.8.1 (issue https://github.com/telefonicaid/fiware-cygnus/issues/387).
Removed after releasing version 1.1.0 (issue 1048).
Hash-based collection names for MongoDB/STH
Added at version 0.8.1 (issue 420).
Never deprecated.
Removed after releasing version 1.4.0 (issue 1113).
enable_raw Carto parameter
Added at version 1.0.0.
Deprecated in favor of enable_raw_historic parameters after releasing version 1.8.0 (issue 1314).
enable_distance Carto parameter
Added at version 1.1.0.
Deprecated in favor of enable_distance_historic parameters after releasing version 1.8.0 (issue 1314).