nim-wiki/Creating-a-release.md

65 lines
2.2 KiB
Markdown
Raw Normal View History

2016-08-11 19:43:28 +00:00
- Run the full testsuite (``tests\testament\tester all``) and ensure it's green; actually ensure travis is green (Usually the case these days)
2015-10-30 13:52:26 +00:00
2016-08-11 19:43:28 +00:00
- Update news.txt
2015-10-30 13:52:26 +00:00
- write a news ticker entry
- Update the version
2015-10-30 14:08:47 +00:00
- In system.nim
2015-10-30 13:52:26 +00:00
- Recompile koch!
- Generate the full docs; koch web0
2016-08-11 19:43:28 +00:00
- Test the installers: koch testinstall
2016-10-23 12:19:22 +00:00
- Tag the release, e.g. ```git tag -am "Version 0.15.0" v0.15.0```
2016-10-23 12:21:01 +00:00
- Push the tag: ```git push origin [tagname]```
2016-10-20 20:33:54 +00:00
2017-09-06 21:04:26 +00:00
- Run ``tools/winrelease``
2018-03-01 00:32:26 +00:00
For this you need to close VSCode so that 'nimsuggest' can be overwritten!
2017-05-17 20:21:11 +00:00
- Upload the produced .zips.
2016-11-01 16:46:44 +00:00
2015-10-30 13:52:26 +00:00
- Merge devel into master
2016-11-01 16:46:44 +00:00
- Update csources via ``koch pushcsources``
2016-08-11 19:50:46 +00:00
2017-05-17 20:29:43 +00:00
**The following shell script shall be replaced by 'koch unixrelease'**
2016-09-27 13:43:29 +00:00
Shell script to build a source tarball:
2016-09-27 13:30:11 +00:00
```sh
#!/bin/sh
set -eu
tmp_dir=$(mktemp -d)
cd $tmp_dir
git clone -q --depth 1 https://github.com/nim-lang/Nim.git
cd Nim
git clone -q --depth 1 https://github.com/nim-lang/csources
( cd csources && sh build.sh )
bin/nim c koch
./koch boot -d:release
./koch web0
PATH=$PATH:$(pwd)/bin
./koch csource -d:release
./koch xz -d:release
```
2017-09-07 20:26:41 +00:00
## Website
2017-09-07 21:30:24 +00:00
### Uploading the binaries
- `scp nim-0.18.0.tar.xz username@servername:/var/www/nim-lang.org/download/nim-0.18.0.tar.xz` (change the version obviously)
### Generating the sha256's
- `ssh username@servername`
- `cd /var/www/nim-lang.org/download/`
- `sha256sum nim-0.18.0.tar.xz > nim-0.18.0.tar.xz.sha256`
### Updating the blog/downloads page
2017-09-07 21:00:03 +00:00
- Create a new blog post in `_drafts` titled: `version-<ver>-released.md` where `<ver>` is the version without any dots, e.g. `0180` for `0.18.0`.
2017-09-07 20:26:41 +00:00
- When ready to release:
2017-09-07 21:01:39 +00:00
- move the blog post into `_posts`, making sure to append the current date to its filename: `2017-09-31-title.md`.
2017-09-07 20:26:41 +00:00
- modify config.yml's `version` key to the new version
- `git commit`
2017-09-07 20:56:14 +00:00
- **TIP:** Here is a real-life example of a commit that signifies a release: https://github.com/nim-lang/website/commit/6f95916dee1212dcf5465d74dcff14e01f714503. The draft blog post was created in earlier commits, but hopefully it's pretty easy to figure out how it was made.
- **TIP2:** You can see what a draft post looks like by running `jekyll serve --drafts` inside the website's `jekyll` directory.
2017-09-07 20:26:41 +00:00
- `git push live master` (the `live` remote is a strict secret)