Update for release helper

Ben Goldsworthy 2021-03-18 22:49:48 +00:00
parent 33c816ac08
commit 88a7b47813

@ -6,19 +6,16 @@ Version control with SVN is different to Git. Each SVN revision includes a snaps
Subversion is for release control, not development. This Git repo, hosted on GitHub, is for development.
# Pushing Code to the WP Plugin Directory
# How to Make a New Release
1. Copy the SVN repo. locally (`svn co https://plugins.svn.wordpress.org/footnotes/ footnotes-svn`);
1. Enter the folder (`cd footnotes-svn`);
1. Copy over the files from your local copy of this repo. (**make sure you have checked out the `main` branch**) into the `trunk/` directory;
1. **MAKE SURE THAT THE Stable Tag FIELD IN `trunk/readme.txt` IS THE LATEST RELEASE VERSION, NOT DEVELOPMENT!**
1. View the changes (`svn stat`);
1. If you are adding/removing any files, make sure you add them to/remove them from tracking using `svn add`/`svn rm`
1. Commit your changes (`svn ci -m "<your message>"`);
1. Pull down another copy of the repo. to test locally;
1. When the new version is ready for release, update the Stable Tag field in `trunk/readme.txt`;
1. Make sure the version number in trunk/footnotes.php is now in sync with the Stable Tag version;
1. Copy trunk/ to its tagged folder: `svn cp trunk tags/<new version>`;
1. Commit the release: `svn ci -m $'<full changelog of that version including the heading and with line breaks converted to \n>'`
When we're ready to create a new pre-release, whoever has been designated to do so just has to run the command `composer run release` (to test) or `composer run release:commit` (to push the pre-release version to the remote SVN repo.).
The WP Plugin Directory will automatically handle the release.
The pre-release (or 'p') codebase will then go through a period of testing, and when we're happy with it, someone will be designated to push the release by following these steps:
1. update the Stable Tag field in the local copy of `trunk/readme.txt` to the new version;
2. update the Version field in the comment header of the local `trunk/footnotes.php` to the new version;
3. remove the p from the end of the version tag in the `getInfo()` function at the bottom of the local `js/wsiwyg-editor.js`;
4. copy a new tag for the release from the local `trunk/` (`svn cp trunk tags/<version number>`); and
5. commit your changes (`svn ci -m "Release version <version number>"`).
The WP Plugin Directory will automatically parse the Stable Tag field in `trunk/readme.txt`, and inform users that a new version is available.