Differences between revisions 2 and 3
Revision 2 as of 2017-08-20 07:23:45
Size: 2183
Editor: ?LarsKruse
Comment: fixed links to sprint pages
Revision 3 as of 2017-08-20 08:50:25
Size: 4319
Editor: ?LarsKruse
Comment: document possible mailing list migration to lists.d.o
Deletions are marked like this. Additions are marked like this.
Line 44: Line 44:
== Import Mailinglist ==
''Salsa'' does not offer any mailinglist features.
== Import mailing list ==
''Salsa'' does not offer any mailinglist features on its own (see [[Sprints/2017/Alioth/MeetingMinutes/Mailinglist|discussion]]).
Line 47: Line 47:
You may want to take a look at the [[Sprints/2017/Alioth/MeetingMinutes/Mailinglist|reasons for not providing mailinglists]] within ''Salsa''. Some mailing lists that were formerly hosted on Alioth may be eligible for being hosted on [[https://lists.debian.org|lists.debian.org]]. The lists eligible for migration must follow the requirements outlined on the [[https://www.debian.org/MailingLists/HOWTO_start_list|"How to ask a mailing list" guide]]. The process is also the same as outlined on the guide.

The following kind of lists are probably acceptable for [[https://lists.debian.org|lists.debian.org]]:
 * The list is expected to be useful, to have a purpose and an audience.
 * Public discussion or support lists are probably OK.
 * Commit or bug notifications lists are not OK. You should use the dedicated features of gitlab instead. If you're interested in a package's bug, you're expected to subscribe to it using the [[http://bugs.debian.org/|BTS]] features.

Short version: file a bug on the [[https://bugs.debian.org/lists.debian.org|pseudo-package lists.debian.org]] with the severity 'wishlist', with the following information:
 * List Name
 * Rationale (why do you need this list, stating that you had one on Alioth is not enough!)
 * Short Description (for display in list indices)
 * Long Description (targeted to people that need to decide if they want to join)
 * Category

Lists migrated from Alioth are expected to be open, that is:
 * Open Subscription Policy (no closed lists)
 * Open Post Policy (anybody can post)
 * Open Archive

If you do want the archive and/or the subscribers to be imported into your new mailing list, please:
 * on alioth, using your ssh access, run 'sudo /usr/local/bin/export-list <mailing_list_name>' to get gzipped tar archive (on stdout) containing:
  * mbox file of the archive
  * subscribers list in simple text file
 * import the resulting mbox file in your favorite e-mail reader and clean the spam,
 * attach the compressed archive and/or the list of subscribers to your request.
 
Also, please understand that the requirements and features for lists on lists.debian.org are not the same as for a mailing list on Alioth, and the listmaster might reject your request. Lists.debian.org is not supposed to replace all mailing lists and aliases on Alioth.

Work in Progress

The service described below is not public, yet. Please ignore any related information until it is officially published.

Even the name (Salsa) is not official, yet.

Salsa Documentation

Salsa is a collaborative development platform within Debian.

Users: Login and Registration

  • Debian Developers can login with their Debian email address

    • you need to use your official Debian email address in order to gain specific permissions for Debian Developers
  • everyone else can register an account with an implicitly added suffix -guest

Namespace concepts (Users, Teams, Packages, ...)

  • TODO

Permissions

TODO:

  • Debian Developers
  • everyone else
  • Group Administrators

Hints for previous users of Alioth

Salsa provides services which partially replace some features of the former Alioth service. The following hints may help you to move your packaging collaboration effort from Alioth to Salsa.

Many Alioth features are (intentionally) not provided by the Salsa platform. You may want to take a look at the related discussion during a sprint for the detailed reasons for this decision.

Import git repository

TODO

Import non-git version control repository

Only git repositories are supported by the Salsa platform.

You may want to take a look at the ?reasons for not supporting other version control systems within Salsa.

Import mailing list

Salsa does not offer any mailinglist features on its own (see ?discussion).

Some mailing lists that were formerly hosted on Alioth may be eligible for being hosted on lists.debian.org. The lists eligible for migration must follow the requirements outlined on the "How to ask a mailing list" guide. The process is also the same as outlined on the guide.

The following kind of lists are probably acceptable for lists.debian.org:

  • The list is expected to be useful, to have a purpose and an audience.
  • Public discussion or support lists are probably OK.
  • Commit or bug notifications lists are not OK. You should use the dedicated features of gitlab instead. If you're interested in a package's bug, you're expected to subscribe to it using the BTS features.

Short version: file a bug on the pseudo-package lists.debian.org with the severity 'wishlist', with the following information:

  • List Name
  • Rationale (why do you need this list, stating that you had one on Alioth is not enough!)
  • Short Description (for display in list indices)
  • Long Description (targeted to people that need to decide if they want to join)
  • Category

Lists migrated from Alioth are expected to be open, that is:

  • Open Subscription Policy (no closed lists)
  • Open Post Policy (anybody can post)
  • Open Archive

If you do want the archive and/or the subscribers to be imported into your new mailing list, please:

  • on alioth, using your ssh access, run 'sudo /usr/local/bin/export-list <mailing_list_name>' to get gzipped tar archive (on stdout) containing:

    • mbox file of the archive
    • subscribers list in simple text file
  • import the resulting mbox file in your favorite e-mail reader and clean the spam,
  • attach the compressed archive and/or the list of subscribers to your request.

Also, please understand that the requirements and features for lists on lists.debian.org are not the same as for a mailing list on Alioth, and the listmaster might reject your request. Lists.debian.org is not supposed to replace all mailing lists and aliases on Alioth.

Import members of a team

It is not possible to transfer the members of an Alioth team to Salsa. You will need to ask the members of your team to join your team on Salsa individually.

Getting Help

See the Salsa maintenance description.