contributors.debian.org mini-sprint report

--nijvGQmueD3J+WGn
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Hello,

taking advantage of geography, me and Mattia Rizzolo met for 3 days for
an impromptu sprint on contributors.debian.org.

At DebConf 25, thanks to salsa.debian.org admins and with the help of
Ian Jackson, contributors.debian.org started receiving notifications of
gitlab activity, and we decided to meet to finally implement processing
of this data stream.


## During the sprint we did:

* dust off contributors.debian.org code
* configured the contributors CI to target trixie, and with DSA upgraded
  the hosting server to Trixie
* improve the housekeeping tasks that were requiring too many manual
  interventions
* implemented a housekeeping task to aggregate the queue of salsa
  webping notifications into a private database table
* implemented the ability to track activity by Salsa user IDs. This is
  opt-out for DDs (you can hide all contributions from a salsa
  identifier) and opt-in for non-DDs (you can unhide contributions from
  a salsa identifier)
* improved the display of personal identifiers in one's personal page
* implemented a way to configure a contribution type to match salsa
  project names, which will automatically populate contributions from
  Salsa's webpings

Not related to contributors.debian.org, but while on it:

* on nm.debian.org, show a warning for key signatures that are valid but
  use obsolete hash algorithms


## What does it mean for you?

### Salsa user ID on contributors.debian.org

Contributors tracks contributions by email, login, GPG key, and so on.
Now it can also track them by numeric salsa user IDs.

If you log on contributors.debian.org and navigate to your personal
page, under "User visiblity" you can now find an entry for each salsa
account you used to log into contributors.debian.org. You can use the
"Hidden" checkbox to opt-in or opt-out of publicly crediting
contributions made with that identifier.


### Configure automatic submission of contributions from salsa activity

If you maintain a data source, when editing a contribution type there
are now two new fields: "Salsa projects" and "Salsa events".

You can set "Salsa projects" to a comma separated list of namespaced
salsa project names, and it will match all contributions from the given
project and all subprojects.

For example, the salsa.debian.org "debian" contribution[1] is configured
to use "debian/" as the value for "Salsa Projects", matching everything
under debian.

The Debusine "debusine_code" contribution[2] uses instead
"freexian-team/debusine" to match the debusine project.

"Salsa events" can be set to "push", "mr", or "push, mr", to filter the
activity type from salsa. Leaving it empty will aggregate all activity
=66rom the matched projects.

[1] https://contributors.debian.org/source/salsa.debian.org/ctype/debian/
[2] https://contributors.debian.org/source/Debusine/ctype/debusine_code/


### How automatic salsa submissions happen

Webpings from salsa are stored in a queue and processed in the daily
housekeeping task, when they get aggregated into ranges of dates, and
can then be matched by contribution types configured to do so.

For each contribution type that has "Salsa projects" set, data is
extracted from the aggregated table into a contribution submission that
is then enqueued for processing.=20

If you maintain a data source, you can find these submissions under the
"Submissions" view (click on "Imports" from the "data sources" view).
[3] https://contributors.debian.org/source/

When configuring a data source, you can also generate a submission on
the fly from the data source page, so you can review it to fine tune it.

Note that since the data stream was set up at DebConf25, we don't have
any data from before 2025-07-18. You can use `dc-tool` from the
python3-debiancontributors package to fill earlier contributions, for
example by scanning the history of relevant git repositories.


### Show your team activity on contributor.debian.org!

Any DD can create new data sources on contributors.debian.org, and any
team that uses Salsa for shared work can now set up a team page as a
data source on contributors.debian.org to credit their contributors. We
hope this can help making work more visible. Give it a try!


Enrico and Mattia

--=20
GPG key: 4096R/634F4BD1E7AD5568 2009-05-08 Enrico Zini <[email protected]=
rg>

--nijvGQmueD3J+WGn
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEzcrDClsZDUbLiHVsQQj4QWUj0N4FAmnl508ACgkQQQj4QWUj
0N5O1w//Ttj4i81X6ILu0ZovHTSCOylFjvrxwvPqQRtYsd+qn1n6SWu49v7q4AjM
fye6k8kHju3nAJqO8EAQ1SWuUoZUfsSDjigwwEOCCw92Mhn+GNN1QJ7pPCE/q9l4
ofPElblXZuzlsJoiT/LwgL9ex+eB6nIUJ1KJQFqo3cGmn0rW1QuXHOcHyynkKXdV
BO+drFou4k5JvNdFFNFm3pzaq6BXSuKnlqG9IlyM107dHyjHMX5cAe60EaBbo96X
o+KizE5bD4b50qOR4pEkZSrl9AHrAUFiPeufp/DpBsPFQRqOXTRo1Q6644XIVaaN
YlpKcRY5gms56UeeGvAsENl3K7yykJ8QpK8pHLmfuswt2d8IKZdEpwpMIELdFmin
2XkBC9X+/Y6PLimXRUQ6O3xbn+xCeLPTm5SnHgDnhhAyX/dKmhRILlKBLHGv+XJY
zWccofyYYOKe/zpXPdEugoxuRxFbREOEehxKCFvWN04V61liasF/Pfv/KCho20A6
RIX7GklYsJ2PC2wxQO780gx2GEq0Y5ZlhQgJI5aioke9CAsXoj4fS8yT+JtmsRkB
zI6ShFWZsMpePqx6koeMY8af1pZ/T8hIiBv6r2b2gbq5auhbtZmcS4cIVmyWJySX
L/IpF84xATvmob0DFJ6vTYRnHihNubpLW8kCT8VnPTJrDoBsTbY=
=8ZMG
-----END PGP SIGNATURE-----

--nijvGQmueD3J+WGn--