Software Heritage Wiki - User contributions [en]

Main Page

2023-11-30T09:33:22Z

Bchauvet:

Welcome to the wiki of [[Software Heritage]].

We are just getting started, so please bear with us while we organize the content of the wiki.<br >
In the meantime you can find below entry points for various communities we're collaborating with.

== General ==

* [[Suggestion box]] for software we should add to the [[Archive]] ← add your entry here!
* [[Talks]] about Software Heritage

== Developers ==

* Read the [https://docs.softwareheritage.org/devel/ docs]
* Dive into the [https://forge.softwareheritage.org/ code]
* Subscribe to the [[Mailing lists]]
* Chat with us on [[Matrix]]

== Scientists ==

* [[:Category:Related work|Related work]]
* [[Working groups]]

== Students ==

* [[Internships|Internship opportunities]]
* [[Google Summer of Code 2022]]

== Ambassadors ==
* [[Ambassadors onboarding]]

IRC

2023-11-30T09:32:45Z

Bchauvet: Bchauvet moved page IRC to Matrix: Switch from IRC to full Matrix

#REDIRECT [[Matrix]]

Matrix

2023-11-30T09:32:45Z

Bchauvet: Bchauvet moved page IRC to Matrix: Switch from IRC to full Matrix

== Matrix rooms ==

The following rooms have been registered on the [https://matrix.org/ matrix.org] network for [[Software Heritage]] usage.

* [https://app.element.io/#/room/#swh-devel:matrix.org '''#swh-devel''']: public development discussions
* [https://app.element.io/#/room/#swh-sysadm:matrix.org '''#swh-sysadm''']: operations team discussions/bots
* [https://app.element.io/#/room/#swh-offtopic:matrix.org '''#swh-offtopic''']: Off-topic discussions
* [https://app.element.io/#/room/#swh-team:matrix.org '''#swh-team''']: private discussions of the core team
* [https://app.element.io/#/room/#swh:matrix.org '''#swh''']: general discussions around Software Heritage

You will be asked to create a [https://element.io/ Element] account if you don't have one yet.

Software Heritage has made the decision to close their former [https://libera.chat libera.chat] IRC channels from 2023/12/08

Matrix

2023-11-30T09:26:55Z

Bchauvet: switch to full matrix

Matrix

2022-06-29T15:31:07Z

Bchauvet:

== IRC channels ==

The following channels have been registered on the [https://libera.chat/ libera.chat] IRC network for [[Software Heritage]] usage.

* [https://app.element.io/#/room/#swh-devel:matrix.org '''#swh-devel''']: public development discussions
* [https://app.element.io/#/room/#swh-sysadm:matrix.org '''#swh-sysadm''']: operations team discussions/bots
* [https://app.element.io/#/room/#swh-offtopic:matrix.org '''#swh-offtopic''']: Off-topic discussions
* [https://app.element.io/#/room/#swh-team:matrix.org '''#swh-team''']: private discussions of the core team
* [https://app.element.io/#/room/#swh:matrix.org '''#swh''']: general discussions around Software Heritage

If you use IRC, consider joining the channels.

If you don't use IRC ''directly'', you can still join our chat channels from your web browser via a [https://matrix.org/ Matrix] bridge by clicking on the channel names in the list above. You will be asked to create a [https://element.io/ Element] account if you don't have one yet.

== IRC authentication ==

<b>Libera.chat defaults to blocking private messages from unauthentified users! All users should register their nicknames to be able to message one another privately, by following the instructions below.</b> If you're really unable to register, you should ask your correspondent to [https://libera.chat/guides/usermodes consider setting usermode <tt>-R</tt>, and <tt>+g</tt>]

To register an account with NickServ, please follow [https://libera.chat/guides/registration the registration instructions provided by libera.chat staff].

You will then receive an e-mail containing a link to activate you account. After doing so, you need to configure your client to auto-authenticate. The recommended way of doing that is using [https://libera.chat/guides/sasl SASL authentication].

For matrix, the relevant docs is here: https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv

libera.chat also supports authentication via [https://libera.chat/guides/certfp TLS client certificates (using SASL EXTERNAL)].

=== Matrix bridge ===

For registering an account through the Matrix bridge ([https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv relevant docs here]), please follow these instructions:

1. Choose a short nickname (the default nickname picked by the matrix bridge has a [m] and can be quite long, as it defaults to the full local part of your matrix handle)

/msg @appservice:libera.chat !nick <USERNAME>

2. Send this command to NickServ to register your account:

/msg @NickServ:libera.chat register <PASSWORD> <EMAIL>

3. Once you receive the confirmation email with a token, activate your account by using:

/msg @NickServ:libera.chat VERIFY REGISTER <USERNAME> <TOKEN RECEIVED BY EMAIL>

4. Give the Matrix bridge appservice your password so that you get identified automatically when matrix reconnects you to IRC:

/msg @appservice:libera.chat !username <USERNAME>
/msg @appservice:libera.chat !storepass <PASSWORD>

== IRC access list ==

To auto-voice people with a registered nick (only doable by people with +fA access modes will be able to do it), add them to the team channel access list:

/msg chanserv flags #swh-team add <nickname> Staff

Other channels pick their ACLs from that of the #swh-team channel.

If you already have the right (+o ChanServ flag), you can make yourself an operator, with:

/msg chanserv OP #swh-devel

[[Category:Infrastructure]]