[Debian-salsa-ci] Is Salsa CI easy to use for anyone learning Debian packaging?

[Phil Wyett]

On Sat, 2024-12-21 at 23:00 -0800, Otto Kekäläinen wrote:
> Hi!
> 
> Salsa CI is a great system for all aspiring Debian packagers to test
> their packages before requesting review from mentors, or for even
> experienced packagers before uploading to Debian.
> 
> Anyone with a Salsa account can use it. Simply follow the README at
> https://salsa.debian.org/salsa-ci-team/pipeline to get started and to
> find the optimal settings for your specific package.
> 
> However, I wonder is it straightforward enough for everyone?
> 
> I am in the process of doing a round of updates to the README. All
> feedback on how to improve the documentation so it is easy to digest
> in particular for newcomers is welcome as replies to this email or as
> comments at https://salsa.debian.org/salsa-ci-team/pipeline/-/merge_requests/563.
> 
> - Otto

Morning Otto,

A suggestion below. I will work my way through the document over the next few
days.

At the top of the document is:

Salsa CI – Quality Assurance for Debian packaging

TL;DR

This Salsa CI pipeline increases the quality of Debian packages by providing
Continuous Integration that can be run on every commit on any Debian package.

change to:

Salsa Continuous Integration (CI) – Quality Assurance for Debian packaging

TL;DR

This Salsa Continuous Integration (CI) pipeline increases the quality of Debian
packages by providing Continuous Integration that can be run on every commit on
any Debian package.

A tweak at the head of the document to use the complete wording with acronym
following it in parenthesise. This by reading it twice should solidify the new
readers knowledge that CI from here in in is Continuous Integration when
reading further.

Regards

Phil

-- 

Donations...

Buy Me A Coffee: https://buymeacoffee.com/kathenasorg

Liberapay: https://liberapay.com/kathenas

--

"I play the game for the game’s own sake"

Arthur Conan Doyle - The Adventure of the Bruce-Partington Plans

--

Internet Relay Chat (IRC): kathenas

Matrix: #kathenas:matrix.org

Website: https://kathenas.org

Wiki: https://wiki.kathenas.org

Instagram: https://instagram.com/kathenasorg

Threads: https://www.threads.net/@kathenasorg

--












-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 870 bytes
Desc: This is a digitally signed message part
URL: <http://alioth-lists.debian.net/pipermail/debian-salsa-ci/attachments/20241222/42042839/attachment.sig>