Skip to content

RPM building documentation overhaul for SVN to Git migration#175

Merged
matyasselmeci merged 17 commits intoosg-htc:masterfrom
matyasselmeci:pr/osg-build-git-update.SOFTWARE-5893
Feb 11, 2026
Merged

RPM building documentation overhaul for SVN to Git migration#175
matyasselmeci merged 17 commits intoosg-htc:masterfrom
matyasselmeci:pr/osg-build-git-update.SOFTWARE-5893

Conversation

@matyasselmeci
Copy link
Copy Markdown
Contributor

This PR adds instructions for how to use the new osg-htc/software-packaging repository, and overhauls the Software Development Process, Koji Workflow pages to remove a lot of the built-up cruft that no longer applies.
The OSG Build Tools and RPM Development Guide pages had smaller updates since they'd already been recently touched.

The "Software Development Process" page needed the most attention:

  • Generic advice on software versioning was removed.
  • Developer testing now basically means running VMU tests -- we no longer to the "standard 4" manual tests on VMs.
  • Promotion permission can be granted by any SW team member, not just the manager.
  • Advice on how to do SVN merges to copy between release series (to make archaeology easier) was replaced with advice on how to structure Git commits for the same purpose.
  • Outdated scripts and processes (e.g. use of built-against-pkgs and hand-submitting the VMU DAG) have been replaced.
  • The suggested text for a promotion request has been updated to reflect what we actually do.

The "Koji Workflow" page was more search-and-replace with some other tweaks along the way:

  • Examples were updated to refer to software we still ship.
  • Tags were updated to the post-23 style.
  • The description of regen-repo was updated with how current versions of Koji do it -- manually waiting for a repo to regen before starting the next build is no longer necessary.
  • The example for a scratch build also adds --getfiles.

The "OSG Build Tools" and "RPM Development Guide" docs had some smaller changes:

  • The standalone doc on Quilt ("How to Write a Patch") was merged into the OSG Build Tools doc to reduce duplication.
  • Special information about how to build for upcoming was removed.
  • Repo name changes, path changes, etc.
  • Info on what to put in the Makefile of OSG-owned software was removed.

Copy link
Copy Markdown
Contributor

@brianhlin brianhlin left a comment

Choose a reason for hiding this comment

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

LGTM! Minor comments but I don't think they need to hold up the train

Comment thread docs/software/development-process.md Outdated
Comment thread docs/software/development-process.md Outdated
Comment thread docs/software/koji-workflow.md Outdated
@matyasselmeci matyasselmeci force-pushed the pr/osg-build-git-update.SOFTWARE-5893 branch from f1883d3 to 0501aac Compare February 10, 2026 23:59
matyasselmeci and others added 17 commits February 10, 2026 18:03
* Suggest using `--getfiles` by default for scratch builds -- it's useful.
* Koji now waits for repos to get regenerated before subsequent builds.
* Use modern tag names (like 25-main) in the examples.
* Remove the info about building before the repo is ready -- no longer an issue.
* Use an example package that we still ship.
* Use <br> instead of trailing space.
* Jira is not an acronym.
*   Versioning guidelines - seems superfluous with all the other versioning guides
    out there (e.g. semver.org).
*   Drop reference to `built-against-pkgs` which no longer exists.
*   Use software we still build in Koji as the example, instead of htcondor-ce.
*   Mention pinging the software team on Jira for the promotion request.
*   Require a link to VMU tests.
*   Update the phrasing to what we actually use.
@matyasselmeci matyasselmeci force-pushed the pr/osg-build-git-update.SOFTWARE-5893 branch from 0501aac to 4a197b4 Compare February 11, 2026 00:03
@matyasselmeci matyasselmeci merged commit e10eb4f into osg-htc:master Feb 11, 2026
1 check passed
@matyasselmeci matyasselmeci deleted the pr/osg-build-git-update.SOFTWARE-5893 branch February 11, 2026 00:04
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