Skip to content
This repository has been archived by the owner on Nov 15, 2023. It is now read-only.

Let PR titles spread accross multiple lines in the release notes #5521

Merged
merged 1 commit into from
Jun 21, 2022

Conversation

chevdor
Copy link
Contributor

@chevdor chevdor commented May 13, 2022

Truncate at 120 chars vs the previous 60.
60 was barely triggering in the past so 120 favors completeness of the information vs having 100% everything fit on a single line.

@chevdor chevdor added A0-please_review Pull request needs code review. B0-silent Changes should not be mentioned in any release notes C1-low PR touches the given topic and has a low impact on builders. labels May 13, 2022
@chevdor chevdor requested review from dvdplm and wpank May 13, 2022 14:50
@chevdor chevdor requested a review from a team as a code owner May 13, 2022 14:50
@paritytech-ci paritytech-ci requested a review from a team May 16, 2022 07:57
Copy link
Contributor

@dvdplm dvdplm left a comment

Choose a reason for hiding this comment

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

I still think we should avoid truncation and that the limit should be much longer, just as a sanity thing (1024 or thereabouts), but this is better than 60, in fact it's twice as good.

@chevdor
Copy link
Contributor Author

chevdor commented May 19, 2022

I also came across GHA such as this one that may help enforcing the format. I also made a test and there is not much preventing a user to make a crazy title.

@dvdplm I think 120 is very close to your 1024 example in the sense that we wil likely never hit it. It is something we can monitor though and we can revisit the topic if we hit a title longer than 120 and agree that it makes sense to have it so long.

@paritytech-ci paritytech-ci requested a review from a team June 21, 2022 08:21
@chevdor chevdor merged commit 1d90fd5 into master Jun 21, 2022
@chevdor chevdor deleted the wk-truncate-less branch June 21, 2022 08:46
@@ -38,5 +38,5 @@
{%- else -%}
{%- set xcm = "" -%}
{%- endif -%}
{{- repo }} {{ audit }}[`#{{c.number}}`]({{c.html_url}}) {{- prio }} - {{ c.title | capitalize | truncate(length=60, end="…") }}{{xcm }}
{{- repo }} {{ audit }}[`#{{c.number}}`]({{c.html_url}}) {{- prio }} - {{ c.title | capitalize | truncate(length=120, end="…") }}{{xcm }}
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd have gone for wider still, 1024. :)

Copy link
Contributor Author

@chevdor chevdor Jul 7, 2022

Choose a reason for hiding this comment

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

Seeing some of the releases notes and considering the GH width limit, the limits for a line seems to be around 88 chars left for the PR description. I would even set it to down to 80 to prevent the following:
image
(This is an extract of the draft for v0.9.26-rc2)

NOTE: No matter how big/wide is your screen, the width is set by the GH UI.

So I would go back lower :)

ordian added a commit that referenced this pull request Jun 21, 2022
* master:
  Zombienet re-enable upgrade test (#5691)
  bump versions to 0.9.25 (#5684)
  update weights (#5704)
  Let PR titles spread accross multiple lines in the release notes (#5521)
  Companion: Bump syn (#5701)
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
A0-please_review Pull request needs code review. B0-silent Changes should not be mentioned in any release notes C1-low PR touches the given topic and has a low impact on builders.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants