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

Latest commit

 

History

History
147 lines (101 loc) · 4.92 KB

PUBLISH.md

File metadata and controls

147 lines (101 loc) · 4.92 KB
Raw

How to publish the GNU MCU Eclipse QEMU binaries?

Build

Before starting the build, perform some checks.

Check the CHANGELOG file

Open the CHANGELOG.txt file from gnu-mcu-eclipse/qemu-build.git and check if all new entries are in.

Note: if you missed to update the CHANGELOG.txt before starting the build, edit the file and rerun the build, it should take only a few minutes to recreate the archives with the correct file.

Check the version

The VERSION file should refer to the actual release.

Push the build script git

In gnu-mcu-eclipse/qemu-build.git, if necessary, merge the develop branch into master.

Push it to GitHub.

Possibly push the helper project too.

Run the build scripts

When everything is ready, follow the instructions on the build page.

Test

Install the binaries on all supported platforms and check if they are functional.

Create a new GitHub pre-release

  • go to the GitHub Releases page
  • click Draft a new release
  • name the tag like v2.8.0-3-20180523 (mind the dashes in the middle!)
  • name the release like GNU MCU Eclipse QEMU v2.8.0-3 20180523 (mind the dashes)
  • as description
    • add a downloads badge like [![Github Releases (by Release)](https://img.shields.io/github/downloads/gnu-mcu-eclipse/qemu/v2.8.0-3-20180523/total.svg)](); use empty URL for now
    • draft a short paragraph explaining what are the main changes
  • attach binaries and SHA (drag and drop from the archives folder will do it)
  • enable the pre-release button
  • click the Publish Release button

Note: at this moment the system should send a notification to all clients watching this project.

Prepare a new blog post

In the gnu-mcu-eclipse.github.io-source.git web git:

  • add a new file to _posts/qemu/releases
  • name the file like 2018-05-23-qemu-v2-8-0-3-20180523-released.md
  • name the post like: GNU MCU Eclipse QEMU v2.8.0-3 20180523 released.
  • as download_url use the tagged URL like https://github.com/gnu-mcu-eclipse/qemu/releases/tag/v2.8.0-3-20180523/
  • update the date: field with the current date

If any, close issues on the way. Refer to them as:

  • [Issue:[#1](...)].

Update the SHA sums

Copy/paste the build report at the end of the post as:

## Checksums
The SHA-256 hashes for the files are:

1e93a4fe2c661cace1b28fb633a9e7eb2c20f352b717205ac22cd338fcee101b 
gnu-mcu-eclipse-qemu-2.8.0-3-20180523-0703-centos32.tgz

d4260a47b3322bce6d8d74feb2409b04c45f0b18a2958bb04ed2c802abf60793 
gnu-mcu-eclipse-qemu-2.8.0-3-20180523-0703-centos64.tgz

0a910c2548513cbbead6f4dd3366ccd72ecc1d75a6aee65e40fd92bdc1e5587e 
gnu-mcu-eclipse-qemu-2.8.0-3-20180523-0703-macos.tgz

065bac74d9d70ae240167936f155abb43097e29b7a4d14c53e473e2d76aa7cb9 
gnu-mcu-eclipse-qemu-2.8.0-3-20180523-0703-win32.zip

7b90e76a0705e9c15fe80373f9028934f179b5c75ea3d2f60dc709adc280e021 
gnu-mcu-eclipse-qemu-2.8.0-3-20180523-0703-win64.zip

Update the Web

  • commit the gnu-mcu-eclipse.github.io-source project; use a message like GNU MCU Eclipse QEMU v2.8.0-3 20180523 released
  • wait for the Travis build to complete; occasionally links to not work, and might need to restart the build.
  • remember the post URL, since it must be updated in the release page

Create the xPack release

Follow the instructions on the qemu-xpack page.

Create the final GitHub release

  • go to the GitHub Releases page
  • update the link behind the badge with the blog URL
  • add a link to the Web page [Continue reading »](); use an same blog URL
  • copy/paste the Easy install section
  • update the current release version
  • copy/paste the Download analytics section
  • update the current release version
  • disable the pre-release button
  • click the Update Release button

Tag the build commit

In the gnu-mcu-eclipse/qemu-build project, add a tag with the current version, like v2.8.0-3-20180523 (with v).

Update the README.md

List the new release in the project README.md.

Share on Facebook

  • go to the new post and follow the Share link.
  • DO NOT select On your own Timeline, but On a Page you manage
  • select GNU MCU Eclipse
  • posting as GNU MCU Eclipse
  • click Post to Facebook
  • check the post in the Facebook page

Share on Twitter

  • go to the new post and follow the Tweet link
  • copy the content to the clipboard
  • DO NOT click the Tweet button here, it'll not use the right account
  • in a separate browser windows, open TweetDeck
  • using the @gnu_mcu_eclipse account, paste the content
  • click the Tweet button