SAP/abap2xlsx
1
0
Fork 0
mirror of https://github.com/abap2xlsx/abap2xlsx.git synced 2025-05-05 14:26:09 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
9d318a1bc2
abap2xlsx/docs/contributing/publishing-a-new-release.md
Abo 9d318a1bc2
Update publishing-a-new-release.md (#1054) 
* Update publishing-a-new-release.md

- noted that tags should be created when working from upstream repository (they do not come via PR from outside, only from local branches apparently)
- added note regarding previous tag for auto-generation of release notes

* Remaining occurrence 15 → 16

Co-authored-by: sandraros <34005250+sandraros@users.noreply.github.com>
2022-08-15 11:11:58 +02:00

1.9 KiB
Raw Blame History

Publishing a new release

Let's create a release from time to time, every 1 or 2 months for instance, to contain enough changes, but not too much.

Below are the notes taken while publishing the release 7.16.0.

Version numbering is based on Semantic Versioning 2.0.0:

  • 7: a major release. NB: it will probably not change as we don't want to "make incompatible API changes".
  • 16: a minor release
  • 0: patch level (bug fixes)

Working directly on the upstream repository:

  • create a branch for this new release; suggested naming for the branch: your own prefix - slash - release - number. For example: abo/release7.16.0 OR sandraros/release7.16.0
  • change version in zcl_excel to indicate the new version number
  • push the changes to this new release branch

With GitHub Desktop (or any Git console or Git user interface), add the (lightweight) tag v7.16.0 to this branch; suggested naming for version-related tags is v + version number.

Do a pull request.

Wait for approval/commit(s) merged into the master branch.

Now create the release in GitHub:

  • Click "Releases"
  • Click "Draft a new release"
  • Click "Choose a tag"
  • Type the title, select the previous tag, click "Auto-generate release notes" and click "Preview" to verify; you should have a list with the changes from the previous release, edit as required:
    • +: new feature
    • *: bug fix
    • !: feature modification
    • -: feature removed
  • Click "Publish release"
  • It's done, zip and tar.gz files are automatically assigned to the release
  • The new release appears in the Code home page, with the changelog in the release page itself.