Uploaded image for project: 'James Server'
  1. James Server
  2. JAMES-2699

Deprecation without documentation

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 3.4.0
    • Fix Version/s: 3.3.1
    • Labels:
      None

      Description

      In the current Mailet API there are many deprecated classes and methods marked with the @Deprecated annotation and some also with the @deprecated javadoc tag. However, very few of these have any related documentation on what to use instead, or at least why it is deprecated if there is no alternative. As it is, someone using or implementing the API has no idea what the migration path should be to avoid using these deprecated APIs which may disappear in the future.

      Please document all deprecations, most importantly with what is the recommended way to migrate away from them.

      This may be true for other modules as well, but certainly is in this central API.

       

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              amichai Amichai Rothman
            • Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: