Skip to content

Commit

Permalink
Merge pull request #1283 from ProjectMirador/2.1.4
Browse files Browse the repository at this point in the history
Merge 2.1.4 development branch into master for release.
  • Loading branch information
aeschylus authored Feb 23, 2017
2 parents f9d4d7d + 327c10e commit ea8fa07
Show file tree
Hide file tree
Showing 24 changed files with 132 additions and 302 deletions.
47 changes: 27 additions & 20 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,31 +32,38 @@ Once you have built the necessary files and created a branch for your feature or
Live interactive reloading of the browser each time a file is saved is enabled and used in the `npm start` command. Note that this will require middleware or a [livereload browser extension](http://feedback.livereload.com/knowledgebase/articles/86242-how-do-i-install-and-use-the-browser-extensions).
### Submitting Your Contribution
### Publishing a New Release
1. Ensure all Tests Pass
All development occurs on the pinned development branch. Ensure that all tests with merged features are passing in travis before moving on to the release process. The release consists of merging the main development branch with master, therefore all changes must be fully integrated and functioning in the development branch.
1. Change Version Number in package.json
If the version number included in the `package.json` does not already accurately reflect the version to be released, be sure to increment the number according to [SemVer](http://semver.org/) conventions. Bump the third number for a small patch that does not change or add any new functionality; bump the second number if the branch includes any new features that do not interfere with or change existing features; and bump the first ("major") version number if the changes to be released break or change the API for existing functionality.
2. Merge Development Branch into Master
3. Create a New Local Tag
After all new changes have been merged into master, checkout master locally, and create a git tag for the new version:

#### 1. Ensure all Tests Pass
All development occurs on the pinned development branch. Ensure that all tests with merged features are passing in travis before moving on to the release process. The release consists of merging the main development branch with master, therefore all changes must be fully integrated and functioning in the development branch. Do not create any new release branches until the current release has been merged into master.

#### 2. Change version number in package.json
If the version number included in the `package.json` does not already accurately reflect the version to be released, be sure to increment the number according to [SemVer](http://semver.org/) conventions. Bump the third number for a small patch that does not change or add any new functionality; bump the second number if the branch includes any new features that do not interfere with or change existing features; and bump the first ("major") version number if the changes to be released break or change the API for existing functionality.

#### 3. Merge the Release Branch into Master
For example, if the current release branch is x.x.1, ensure that all feature branches (such as "fix_annotation_bug#1234") have been merged into the x.x.1 release branch as Github Pull Requests, and then merge the x.x.1 (which will be the default branch) into master through the Github interface (through a PR).

#### 4. Create a New Local Tag
After all new changes have been merged into master, checkout master locally, and create a git tag for the new version:
`git checkout master`
`git tag v[VERSION_NUMBER]`
This will give the current state of the project a name and freeze it in time.
4. Push Tag to Github
Now push the tagged version to github (from master):

#### 5. Push Tag to Github
Now push the tagged version to github (from master):
`git push --tags`

This should cause the new version to appear under the "releases" section of the github project page, and will allow npm to access it in the next step.
5. Publish to NPM
Assuming the commiter has access to the project's package management account on npm, publishing the most recent version requires logging into npm on the command line.
Then simply type `npm publish` to post the new package version to the registry.
To configure your npm user locally, refer to the npm-adduser [documentation](https://docs.npmjs.com/cli/adduser).
6. Create Build and Add it to the New Release
Type npm
7. Update the gh-pages Demo Instance to Show Off the Latest Features
7. Update Release Notes
Using the github commit log, compile a bulleted list of the features and changes added to the new release.
8. Announce New Release on the Mailing Lists and Slack
This will cause the new version to appear under the "releases" section of the github project page, and will allow npm to access it in the next step.
#### 6. Create Build and Add it to the New Release
#### 7. Update the gh-pages Demo Instance to Show Off the Latest Features
#### 8. Update Release Notes
Using the github commit log, compile a bulleted list of the features and changes added to the new release.

#### 9. Publish to NPM
Assuming the commiter has access to the project's package management account on npm, publishing the most recent version requires logging into npm on the command line.
Then simply type `npm publish` to post the new package version to the registry.
To configure your npm user locally, refer to the npm-adduser [documentation](https://docs.npmjs.com/cli/adduser).

#### 10. Announce New Release on the Mailing Lists and Slack

### Design Review
Design review can happen in one of two ways, though both ways start with an issue or issues describing the interaction requirements. Once an issue has been created for a new UI-heavy feature, whether or not a prototype is complete, the feature goes up for design review. This is generally a three-step process:
Expand Down
3 changes: 2 additions & 1 deletion Gruntfile.js
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ module.exports = function(grunt) {
'js/lib/paper-core.min.js',
'js/lib/spectrum.js',
'js/lib/i18next.min.js',
'js/lib/i18nextBrowserLanguageDetector.min.js',
'js/lib/i18nextXHRBackend.min.js',
'js/lib/modernizr.custom.js',
'js/lib/sanitize-html.min.js'
],
Expand Down Expand Up @@ -84,7 +86,6 @@ module.exports = function(grunt) {
'css/normalize.css',
'css/font-awesome.min.css',
'css/jquery-ui.min.css',
'css/layout-default-latest.css',
'css/jquery.qtip.min.css',
'css/spectrum.css',
'css/mirador.css',
Expand Down
224 changes: 0 additions & 224 deletions css/layout-default-latest.css

This file was deleted.

1 change: 0 additions & 1 deletion css/mirador.css
Original file line number Diff line number Diff line change
Expand Up @@ -1799,7 +1799,6 @@ ul.scroll-listing-thumbs li .thumb-label {
}

.mirador-viewer .metadata-label {
text-transform: capitalize;
color: #555;
font-style: italic;
}
Expand Down
8 changes: 3 additions & 5 deletions js/lib/i18next.min.js

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions js/lib/i18nextBrowserLanguageDetector.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit ea8fa07

Please sign in to comment.