github.com/ncw/rclone@v1.48.1-0.20190724201158-a35aa1360e3e/RELEASE.md (about)

     1  Extra required software for making a release
     2    * [github-release](https://github.com/aktau/github-release) for uploading packages
     3    * pandoc for making the html and man pages
     4  
     5  Making a release
     6    * git status - make sure everything is checked in
     7    * Check travis & appveyor builds are green
     8    * make check
     9    * make test # see integration test server or run locally
    10    * make tag
    11    * edit docs/content/changelog.md
    12    * make doc
    13    * git status - to check for new man pages - git add them
    14    * git commit -a -v -m "Version v1.XX.0"
    15    * make retag
    16    * git push --tags origin master
    17    * # Wait for the appveyor and travis builds to complete then...
    18    * make fetch_binaries
    19    * make tarball
    20    * make sign_upload
    21    * make check_sign
    22    * make upload
    23    * make upload_website
    24    * make upload_github
    25    * make startdev
    26    * # announce with forum post, twitter post, G+ post
    27  
    28  Early in the next release cycle update the vendored dependencies
    29    * Review any pinned packages in go.mod and remove if possible
    30        * GO111MODULE=on go get -u github.com/spf13/cobra@master
    31    * make update
    32    * git status
    33    * git add new files
    34    * git commit -a -v
    35  
    36  If `make update` fails with errors like this:
    37  
    38  ```
    39  # github.com/cpuguy83/go-md2man/md2man
    40  ../../../../pkg/mod/github.com/cpuguy83/go-md2man@v1.0.8/md2man/md2man.go:11:16: undefined: blackfriday.EXTENSION_NO_INTRA_EMPHASIS
    41  ../../../../pkg/mod/github.com/cpuguy83/go-md2man@v1.0.8/md2man/md2man.go:12:16: undefined: blackfriday.EXTENSION_TABLES
    42  ```
    43  
    44  Can be fixed with
    45  
    46      * GO111MODULE=on go get -u github.com/russross/blackfriday@v1.5.2
    47      * GO111MODULE=on go mod tidy
    48      * GO111MODULE=on go mod vendor
    49   
    50  
    51  Making a point release.  If rclone needs a point release due to some
    52  horrendous bug, then
    53    * git branch v1.XX v1.XX-fixes
    54    * git cherry-pick any fixes
    55    * Test (see above)
    56    * make NEW_TAG=v1.XX.1 tag
    57    * edit docs/content/changelog.md
    58    * make TAG=v1.43.1 doc
    59    * git commit -a -v -m "Version v1.XX.1"
    60    * git tag -d -v1.XX.1
    61    * git tag -s -m "Version v1.XX.1" v1.XX.1
    62    * git push --tags -u origin v1.XX-fixes
    63    * make BRANCH_PATH= TAG=v1.43.1 fetch_binaries
    64    * make TAG=v1.43.1 tarball
    65    * make TAG=v1.43.1 sign_upload
    66    * make TAG=v1.43.1 check_sign
    67    * make TAG=v1.43.1 upload
    68    * make TAG=v1.43.1 upload_website
    69    * make TAG=v1.43.1 upload_github
    70    * NB this overwrites the current beta so after the release, rebuild the last travis build
    71    * Announce!