jsoneditor/misc/how_to_publish.md

1.7 KiB

How to publish jsoneditor

This document describes the steps required to publish a new version of jsoneditor.

Update version number

Update the version number in both package.json and bower.json.

Update history

Update the date and version number in the file HISTORY.md. Verify whether all changes in the new version are described.

Build library

Build the build (jsoneditor.js, jsoneditor.css, ...) files by running:

npm run build

After the build is complete, verify if the files are updated and contain the correct date and version number in the header.

Test

Test whether the npm library is ok by installing it locally:

cd ../tmp-folder
npm install ./path/to/jsoneditor

Check whether the examples in the library work ok, and whether the necessary files are included.

Commit

  • Commit the final code.
  • Merge the develop branch into the master branch.
  • Push to github.

If everything is well, create a tag for the new version, like:

git tag v1.2.4
git push --tags

Publish

Publish to npm:

npm publish

Publish at cdnjs: test after 30 to 60 minutes whether the new version is published at cdnjs (should auto update).

Test published library

Install the libraries locally and test whether they work correctly:

cd tmp-folder
npm install jsoneditor
bower install jsoneditor

Put zip file to website

Create a zipped file of the library by running

gulp zip

Add the file to the downloads folder of the website.

Update version number

Switch to the develop branch, and update the version numbers in package.json and bower.json to a new snapshot version, like

1.2.5-SNAPSHOT

commit and push the changes.

Done

Congrats, be proud.