jsoneditor/misc/how_to_publish.md

92 lines
1.7 KiB
Markdown

# 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.