Skip to content

Start using CI file name salsa-ci.yml#301

Open
ottok wants to merge 2 commits intoDebian:masterfrom
ottok:use-standard-salsa-ci-yml-location
Open

Start using CI file name salsa-ci.yml#301
ottok wants to merge 2 commits intoDebian:masterfrom
ottok:use-standard-salsa-ci-yml-location

Conversation

@ottok
Copy link
Contributor

@ottok ottok commented Feb 19, 2026

See commits for details.

Update the template writer to create the file with the new name
(`debian/salsa-ci.yml`) so that new packages automatically comply with
current Salsa conventions and avoid unnecessary manual renaming.

The file content remains unchanged; only the destination path is updated.
Some existing tooling and documentation still expects the GitLab CI
configuration at the legacy path `debian/gitlab-ci.yml`. To avoid
breaking anything while we migrate to the new standard location
`debian/salsa-ci.yml`, create a compatibility file that simply includes
the new configuration.

This commit in its entirety can be reverted once all references to
`gitlab-ci.yml` have been replaced by `salsa-ci.yml`.
}
defer fCompat.Close()

const compatContent = `# This file exists only for backwards compatibility and can be removed once if this repository CI settings have migrated to use the new file name 'salsa-ci.yml'.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wording is a bit awkward ("once if"), and the line is very long. How about something like this:

Suggested change
const compatContent = `# This file exists only for backwards compatibility and can be removed once if this repository CI settings have migrated to use the new file name 'salsa-ci.yml'.
const compatContent = `# This file exists only for backwards compatibility and can be removed once all documentation and
# tools have migrated to use the new file name 'salsa-ci.yml'.


const compatContent = `# This file exists only for backwards compatibility and can be removed once if this repository CI settings have migrated to use the new file name 'salsa-ci.yml'.
include:
- local: 'debian/salsa-ci.yml'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be worth adding a comment noting that this path is relative to the repository root, not relative to the file doing the import, and link to the GitLab documentation.

However, the GitLab documentation isn't entirely clear. The phrase "a full path relative to" is awkward—how can a full path be relative to anything? Maybe it would be better to make this an absolute path (/debian/salsa-ci.yml) to hedge against a future GitLab version that might change the behavior of relative paths.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants