Versions Compared

Old Version 3

changes.mady.by.user Robert Munteanu

Saved on

compared with

New Version 4

changes.mady.by.user Bertrand Delacretaz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Create a branch "maintenance" with the last version before deprecation
  2. Empty the master branch and only leave a sole README.md file with the added line
    "For reference or potential bugfix releases use branch maintenance"
    (where "maintenance" is linked to the branch where the code still exists, see https://github.com/apache/sling-org-apache-sling-starter-startup as example)
  3. Tag the module as deprecated  using the .asf.yaml features for git repositories feature. If no such file is present make sure to use the default values from Using Git with Sling#Boilerplatefiles .

Deprecated Sling repositories can then be found with the GitHub query https://github.com/search?utf8=✓&q=topic%3Asling+topic%3Adeprecated


Info
titleReasoning for the approach
  • the README file with the obsolete text is not overseen (with the
    long list of folders/files from src/main, CONTRIBUTING.md, to pom.xml the
    notice in the README would get easily overlooked)
  •  if necessary it's still possible to look at the code (easy enough with one click) or even release from it (maven-release-plugin does not worry too much about branch names)

...