Gerrit/Inactive projects

From MediaWiki.org
Jump to navigation Jump to search

Background[edit]

This page is about marking code repositories with no recent activity. For previous discussion see phab:T102920.

Definitions[edit]

(Possibly) Inactive code repositories are defined by:

  • Premise: no patches have been merged to the repository in at least 180 days (localization updates don't count).
  • POSSIBLY INACTIVE: If there are open changesets submitted without any review or stuck with 0/+1 after 90 days, the repository is labelled POSSIBLY INACTIVE. Ideally, a notification would be sent to the identified maintainers and other contributors to the project.
  • INACTIVE: If there are open changesets submitted without any review or stuck with 0/+1 after 180 days, the repository is labelled INACTIVE.

UNUSED code repositories instead are defined as one where no users are known for the software. Or no users should exist of the repository as the software moved to a different one.

Actions to mark a repository as (possibly) inactive[edit]

Note: Some of these steps might require special permissions. Please file a task in Phabricator if you cannot perform all actions.

Actions to deactivate an unused repository[edit]

For an UNUSED repository the steps for an INACTIVE repository need to be done and additionally:

  • Remove the repository from Translatewiki.net by requesting it on the Support page in translatewiki.net or in Wikimedia Phabricator.
  • Remove all files in a new commit or make a commit that disables the software contained in it (e.g. disable the entry point if it is an Mediawiki extension), so that a user that pulls it notices that we assume it has no users and it has no maintainer. See example commit.
  • Set the state in Gerrit to read only: On https://gerrit.wikimedia.org, choose "Projects" and then "List". Find your project and click on the "Project Name". Under "Project Options", set "State" to "Read Only".
  • Remove it from CI/Zuul.
  • In case of a MediaWiki extension or skin project, remove the reference to the project from, respectively, mediawiki/extensions.git or mediawiki/skins.git superproject.
  • If the source code location has changed (e.g. moved from Wikimedia Git/Gerrit to GitHub), also replace the repository content (example).

Actions to mark a repository as active again[edit]

Once a request for ownership has been received, the steps above need to be reverted.

See also[edit]