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

--












Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to