Skip to content

How to release a version of Mirador

Jack Reed edited this page Mar 6, 2019 · 8 revisions

Before releasing, ensure that you're on the master branch. Run all tests and ensure that they pass. Also check the continuous integration server to make sure tests are passing.

$ npm run test
  1. Update the version number in ./package.json. Note: Mirador uses Semantic Versioning to determine version numbers. This should be done as a pull request to allow for community review of the proposed next version number.

    {
      "name": "mirador",
      "version": "{major}.{minor}.{patch}",
      ...
    }
  2. Start drafting GitHub release notes for the tag. Make sure to use the same tag version that was just updated and target the correct branch. Here is a useful template to get started.

    [Commit History](https://github.com/projectmirador/mirador/compare/v3.x.0...v3.x.0) | [Milestone](https://github.com/projectmirador/mirador/issues?q=milestone:{milestone here})
    
    (anything important about this release, themes, etc)
    
    ### New Features and improvements
    
    (#ticketnumber and a human-readable description of the ticket, usually the ticket title. If the ticket title doesn't make sense, either edit the ticket directly, or provide an alternative title here)
    
    ##  Bug Fixes
    
    ### Upgrade Notes
    
    (anything special that needs to be called out)
    

    screen shot 2019-03-06 at 7 16 53 am

  3. Release the npm package

    $ npm publish
  4. Publish the GitHub release

    screen shot 2019-03-06 at 7 16 53 am

  5. Send release announcement to Mirador community