@@ -8,7 +8,7 @@ difficult than it needs to be. Some parts are automated and others can be in
88the future.
99
1010Assuming the code is in a place where a release can be made, for the imagined
11- release version 2.0.123 :
11+ release version 3.2.1 :
1212
13131 . Update the documentation under ` src/site `
1414 - minimally, this means at least:
@@ -21,56 +21,58 @@ release version 2.0.123:
2121 - people who reported issues
2222 - people who created pull requests
2323 - people who suggested code that was implemented
24- 2 . Build release artifacts with ` npm run release `
25- - if this doesn't work, you may need to ` npm ci ` first!
26- 3 . Sign release artifacts (zips & nupkg) under ` build/artifacts `
27- - ` ./scripts/sign-log4net-libraries.sh/ps1 `
28- 4 . Clone out the log4net doc repo (https://github.com/apache/logging-log4net-site )
24+ 2 . Build release artifacts with ` scripts/build-release.ps1 `
25+ - the scripts works on Linux and Windows
26+ - Prerequisites
27+ - PowerShell
28+ - https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows
29+ - https://learn.microsoft.com/en-us/powershell/scripting/install/install-ubuntu
30+ - zip (http://downloads.sourceforge.net/gnuwin32/zip-3.0-bin.zip )
31+ 3 . Clone out the log4net doc repo (https://github.com/apache/logging-log4net-site )
2932 - check out the ` asf-staging ` branch
30- - create a folder which includes the version, eg ` log4net-2.0.123 `
31- 5 . Copy the contents of ` target/site ` from this repo into the folder created in (4)
33+ - create a folder which includes the version, eg ` log4net-3.2.1 `
34+ 4 . Copy the contents of ` target/site ` from this repo into the folder created in (4)
3235 - remember to either update or link in sdk docs from a prior release
33- 6 . Update the symlinks in the base of the docs repo, ie:
34- - 2.0.x -> 2.0.123
35- - 2.x -> 2.0.123
36- 7 . update the ` doap_log4net.rdf ` to point to the new release
37- - (copy-paste-modify an existing release)
38- 8 . update the ` .htaccess ` file
39- - the trailing RewriteRule should point to the new log4net-2.0.123 folder
40- 9 . push the ` asf-staging ` branch to github and wait a bit
36+ 5 . Update the symlinks in the base of the docs repo, ie:
37+ - 3.2.x -> 3.2.1
38+ - 3.x -> 3.2.1
39+ 6 . update the ` doap_log4net.rdf ` to point to the new release
40+ 7 . update the ` .htaccess ` file
41+ - the trailing RewriteRule should point to the new log4net-3.2.1 folder
42+ 8 . push the ` asf-staging ` branch to github and wait a bit
4143 - after a minute or two, check the updates at https://logging.staged.apache.org/log4net
4244 - are you seeing the correct releases page?
4345 - download links should (at this point) not work
44- 10 . create an rc-releasd at GitHub with a tag like ` rc/2.0.123 -rc1 `
46+ 9 . create an rc-releasd at GitHub with a tag like ` rc/3.2.1 -rc1 `
4547 - attach all the files from the build/artifacts folder, _ including signatures_
46- 11 . get the artifacts in build/artifacts up to https://downloads.apache.org/logging/log4net/
48+ 10 . get the artifacts in build/artifacts up to https://downloads.apache.org/logging/log4net/
4749 - ` svn co https://dist.apache.org/repos/dist/dev/logging -N apache-dist-logging-dev `
4850 - ` cd apache-dist-logging-dev `
4951 - ` svn up log4net `
5052 - ` svn delete * `
51- - ` mkdir 2.0.123 `
53+ - ` mkdir 3.2.1 `
5254 - copy all artifacts to the new folder
5355 - ` svn add * `
54- - ` svn commit -m 'log4net 2.0.123 ' `
55- - check https://dist.apache.org/repos/dist/dev/logging/log4net/2.0.123 /
56- 12 . raise a vote on the log4net mailing list (dev@logging.apache.org ) - see MailTemplate.txt
57- 13 . wait
58- 14 . when the vote has 3 or more +1's, it's time to go live!
59- 15 . copy the apache artifacts (binary and source) to the release svn repo and commit
56+ - ` svn commit -m 'log4net 3.2.1 ' `
57+ - check https://dist.apache.org/repos/dist/dev/logging/log4net/3.2.1 /
58+ 11 . raise a vote on the log4net mailing list (dev@logging.apache.org ) - see MailTemplate.txt
59+ 12 . wait
60+ 13 . when the vote has 3 or more +1's, it's time to go live!
61+ 14 . copy the apache artifacts (binary and source) to the release svn repo and commit
6062 - ` svn co https://dist.apache.org/repos/dist/release/logging -N apache-dist-logging-release `
6163 - ` cd apache-dist-logging-release `
6264 - ` svn up log4net `
6365 - ` svn delete ` old items
6466 - copy all artifacts to the new folder
6567 - ` svn add * `
6668 - ` svn commit `
67- 16 . push the .nupkg to nuget.org
69+ 15 . push the .nupkg to nuget.org
6870 - via ` dotnet ` : ` dotnet nuget push <path to package> -s nuget.org -k <your nuget api key> `
6971 - via ` nuget ` : ` nuget push <path to package> -Source nuget.org -ApiKey <your nuget api key> `
70- 17 . don't forget to make the docs live: in the logging-log4net-site folder:
72+ 16 . don't forget to make the docs live: in the logging-log4net-site folder:
7173 - ` git checkout asf-site `
7274 - ` git pull --rebase `
7375 - ` git merge asf-staging `
74- 18 . rename the release at github, eg to ` rel/2.0.123 `
76+ 17 . rename the release at github, eg to ` rel/3.2.1 `
7577 - double-check that the ` rel ` tag is created
76- 19 . apply the next version by calling ` ./scripts/update-version.ps1 2.0.123 2.0.124 `
78+ 18 . apply the next version by calling ` ./scripts/update-version.ps1 3.2.1 3.2.2 `
0 commit comments