[JENKINS-60050] Add title into the ChangeRequestSCMHead interface

[jenkins-infra-bot]

As we know change requests in many git providers are necessary such as GitHub, Gitlab and so on. In my use cases, users want to get the title which they might send build email base on the change request title.

---

Originally reported by surenpi, imported from: Add title into the ChangeRequestSCMHead interface

• assignee: surenpi
• status: In Review
• priority: Minor
• component(s): scm-api-plugin
• label(s): stalled-pr
• resolution: Unresolved
• votes: 0
• watchers: 4
• imported: 20251223-222157

Raw content of original issue

As we know change requests in many git providers are necessary such as GitHub, Gitlab and so on. In my use cases, users want to get the title which they might send build email base on the change request title.

[jenkins-infra-bot]

• Remote link associated with this issue:

  • Pull Request

[jenkins-infra-bot]

bitwiseman:

• Original comment link
• Raw content of original comment:

  I'm sorry, but I disagree with this change.  "ChangeRequestSCMHead" should hold the pertinent SCM information needed to build the the change and I don't see the title as part of that. 
  
  For example, the title can change without the meaningful SCM information changing. Should the title be included in `equals()` comparisons?  If the title changes, should a new build be triggered?
  
  I understand it would be convenient to have this information, and I even support the Title of Change requests being added to some shared interface. However, there needs to be some additional discussion of other possible places to add this information and possible effects and changes in behavior.
  
  I'm sorry. I want to support you in making improvements to this part of the API, but I'm have concerns about this improvement as it stands.
  

I'm sorry, but I disagree with this change.  "ChangeRequestSCMHead" should hold the pertinent SCM information needed to build the the change and I don't see the title as part of that. 

For example, the title can change without the meaningful SCM information changing. Should the title be included in `equals()` comparisons?  If the title changes, should a new build be triggered?

I understand it would be convenient to have this information, and I even support the Title of Change requests being added to some shared interface. However, there needs to be some additional discussion of other possible places to add this information and possible effects and changes in behavior.

I'm sorry. I want to support you in making improvements to this part of the API, but I'm have concerns about this improvement as it stands.

[jenkins-infra-bot]

surenpi:

• Original comment link
• Raw content of original comment:

  It's not a perfect solution that putting the title into ChangeRequestSCMHead. Do you have any suggestions about how can we make a connection with it? Maybe add a new interface for the title?
  

It's not a perfect solution that putting the title into ChangeRequestSCMHead. Do you have any suggestions about how can we make a connection with it? Maybe add a new interface for the title?

[jenkins-infra-bot]

kon:

• Original comment link
• Raw content of original comment:

  ObjectMetadataAction (javadoc) has a String getObjectDescription() method that plugins are already using for change request titles. I don't think it's useful to add the same to ChangeRequestSCMHead.
  

ObjectMetadataAction (javadoc) has a String getObjectDescription() method that plugins are already using for change request titles. I don't think it's useful to add the same to ChangeRequestSCMHead.