Skip to content
This repository has been archived by the owner on Oct 17, 2020. It is now read-only.

chore: create CONTRIBUTING.md file #633

Merged
merged 6 commits into from Sep 1, 2020
Merged

chore: create CONTRIBUTING.md file #633

merged 6 commits into from Sep 1, 2020

Conversation

izaera
Copy link
Member

@izaera izaera commented Sep 1, 2020

No description provided.

@wincent
Copy link
Contributor

wincent commented Sep 1, 2020

Taking this for a test drive...

wincent added a commit that referenced this pull request Sep 1, 2020
This changelog was originally managed by:

    https://github.com/skywinder/gitlab-changelog-generator

But after v1.6.1 we started using GitHub milestones instead to record
changes for each release, so we stopped updating it.

On the 3.x-WIP branch we have started using liferay-changelog-generator
and our new CONTRIBUTING guidelines, adding in the following PR,
indicate that we should do the same on this branch too:

    #633

So, I used the following command to generate the missing range:

    npx liferay-changelog-generator --from=v1.6.1 --regenerate --version=v2.19.0

And then edited by hand to note that most of the details for those
releases are still to be found in the milestones
(liferay-changelog-generator bases its output on the merge commit
messages, which mostly aren't present in that range).

Finally, I stripped off the last version (v2.19.0), because I'll
generate that when I actually cut that release (ie. after this PR).

Subsequent updates should be easy, just like the CONTRIBUTING says:

    npx liferay-changelog-generator --version=$VERSION
wincent added a commit that referenced this pull request Sep 1, 2020
This changelog was originally managed by:

    https://github.com/skywinder/gitlab-changelog-generator

But after v1.6.1 we started using GitHub milestones instead to record
changes for each release, so we stopped updating it.

On the 3.x-WIP branch we have started using liferay-changelog-generator
and our new CONTRIBUTING guidelines, adding in the following PR,
indicate that we should do the same on this branch too:

    #633

So, I used the following command to generate the missing range:

    npx liferay-changelog-generator --from=v1.6.1 --regenerate --version=v2.19.0

And then edited by hand to note that most of the details for those
releases are still to be found in the milestones
(liferay-changelog-generator bases its output on the merge commit
messages, which mostly aren't present in that range).

Finally, I stripped off the last version (v2.19.0), because I'll
generate that when I actually cut that release (ie. after this PR).

Subsequent updates should be easy, just like the CONTRIBUTING says:

    npx liferay-changelog-generator --version=$VERSION
@wincent wincent mentioned this pull request Sep 1, 2020
The "master" branch does one tag for all packages, and always releases
all packages, even if nothing changed. So the changelog generator
invocation should just use the version number, with no prefix; sample
update here:

#634
@wincent
Copy link
Contributor

wincent commented Sep 1, 2020

So, it seemed to work after numerous hiccups with Lerna:

lerna success published 30 packages
✨  Done in 253.68s.

Thanks to this Lerna PR I was even able to use a OTP during publishing.

Spot-checking some of the packages:

They all seem good (right version number, and tagged as "latest").

I documented the little things that I needed:

  • Don't need/want the package name prefix in the liferay-changelog-generator invocation.
  • Needed to push manually because Lerna pushed to my fork (origin) instead of the liferay repo.
  • Needed to close milestone manually.

Also, I see post-release tests failing, due to the version number in the snapshot. I will fix that presently (I fixed it the other day too in #630), and see if I can make this not happen on every single release.

@wincent wincent merged commit 3a14fbd into master Sep 1, 2020
@wincent
Copy link
Contributor

wincent commented Sep 1, 2020

Fix for tests: #635

@wincent
Copy link
Contributor

wincent commented Sep 1, 2020

Hopefully this covers everything...

Screenshot 2020-09-01 -124058-JASNPT8l@2x

Screenshot 2020-09-01 -124137-KCF6oe0S@2x

@wincent wincent deleted the contributing branch September 1, 2020 10:59
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants