Page Comparison

Table of Contents

Prerequisites

Become an NPM contributor

...

Create a new NPM user at https://www.npmjs.com.

• Set up your NPM

...

npm set init.author.name "Your Name"
npm set init.author.email "you@edx.org"

...

Confirm your settings: 

npm config ls

...

• • Include your NPM account name and a link to the library (https://www.npmjs.com/package/edx-pattern-library)

  • Add Andy Armstrong (Deactivated) to the ticket

• permissions by following the steps here: ARCHIVE: How do I publish an edX npm package?

Update the version

Update the Pattern Library toolkit version in the code:

1. Create a new branch from master 

   Code Block
   git checkout master git pull git checkout -b USERNAME/library-releaserelease-MM-DD-YYYY

   
   

2. Update the version number:
   • We use semantic versioning.
   • Update bower.json (for the Bower package)
   • Update package.json (for the NPM package)
3. Add release notes to CHANGELOG.md
   • Determine all the changes since the subsequent release
   • e.g. Look at the commits here: https://github.com/edx/uxedx-patternui-librarytoolkit/compare/0.10.0...commits/master
   • Add a new section to CHANGELOG for the release number with bullets for each important change
   Build the minified and uglified production assets:
   

4. Code Block
   gulp build-production

   Add and commit all the updated files

   • Use the commit message "Release <major.minor.patch>"

     • e.g. "Release 0.10.0"

5. Create a PR with your changes using the Pattern Library PR Template.
   • Note: you only need one reviewer for a release PR

6. Merge your changes once you have thumbs

Publish Package to Bower & NPM

The UI Toolkit is available as both bower and NPM packages.  Please follow these instructions for publishing to both package managers.

1. Create a new release in GitHub
   • For example:
     
   • Include the same bullet points from the CHANGELOG
   • Note that Bower will automatically create a new release once the GitHub release has been created

2. Publish the updated version to NPM

   Code Block
   git checkout master git pull npm publish

   
   

3. Confirm that the version updates have been applied:

   • Look at the top of this page: https://www.npmjs.com/package/edx-patternui-librarytoolkit

   • Note that there may be a slight delay before the updated versions appear

Publish the API documentation

1. Publish the updated documentation to GitHub Pages:

   Code Block
   git checkout master git pull gulp doc-publish

   
   

2. Verify that the documentation has been updated: http://ui-toolkit.edx.org/