RMG: Simplify the corelist section

[thibaultduponchelle]

I am unhappy with the "Update Module::CoreList" sections.

Changes

• Move most common command first
• Make the section smaller
• Link to email thread with details on handling Module::CoreList for MAINT releases

---

• This set of changes does not require a perldelta entry.

[thibaultduponchelle]

@iabyn

[iabyn]

I can't really comment. The wording I added to the RMG 12 years ago just reflected that at the time, handling Module::CoreList was complex as it lived in all branches and needed to be consistently version-bumped. I can't remember the details, and I have no idea what (if anything) has changed or improved in the meantime.

[bram-perl]

I don't like this wording very much.

To me the "in most cases" is meaningless because when reading that I will start wondering if my current case is part of the "most cases" or if it's one of the exception cases..

(From just the diff it's not clear if/when "most cases" apply, maybe it's from the rest of the context but I didn't read that yet)

[thibaultduponchelle]

I fixed it by specifying which type of releases are actually concerned

[bram-perl]

That looks better.

The only thing that still bothers me slightly is that it's now unclear what needs to happen for MAINT releases..

While I get that the old section is confusing and annoying and cryptic it might still be better than nothing.. :/

[thibaultduponchelle]

OK, I get the point and you're right. I reinstalled the useful bits from the old section :)

[jkeenan]

@bingos would you like to comment on this pull request re corelist? Thanks.

[thibaultduponchelle]

and I have no idea what (if anything) has changed or improved in the meantime.

@iabyn I don't think anything changed/improved on this side, my proposed change is really about the form and making the paragraph shorter, reordered (with most common case first) and more "accessible"

[thibaultduponchelle]

I updated again and I think I got it right.

The section keeps the useful bits related to MAINT from the old section, better links to the email, reorders to make most common case to appear first, and makes some very little changes on the wording.