From acc07dbc4f4e6923e713dfc17bb81a52e14dea7a Mon Sep 17 00:00:00 2001 From: Nathan Glenn Date: Tue, 30 Apr 2024 12:59:34 -0500 Subject: [PATCH] Begin 9.6.3 change notes; update release process --- readme.md | 4 ++- txt/Release_Notes_9.6.3.md | 67 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 70 insertions(+), 1 deletion(-) create mode 100644 txt/Release_Notes_9.6.3.md diff --git a/readme.md b/readme.md index abc7a93..ab0cbd3 100644 --- a/readme.md +++ b/readme.md @@ -29,7 +29,7 @@ VisualSoar and Eaters_TankSoar must be built from their repositories (although I * Set your environment variables for SoarShuffler. Here's my .env for an example (you can source this automatically using tools like [dotenv](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dotenv)): ```bash -export SOAR_RELEASE_VERSION=9.6.2 +export SOAR_RELEASE_VERSION=9.6.3 export SOAR_SHUFFLER_OUTPUT_DIR=./Soar-Release-$SOAR_RELEASE_VERSION export SOAR_WIN_X86_64_COMPILED_DIR=~/Downloads/Soar_windows-x86-64_out export SOAR_LINUX_X86_64_COMPILED_DIR=~/Downloads/Soar_linux-x86-64_out @@ -53,4 +53,6 @@ You'll get the release directories wherever you specified in the `SOAR_SHUFFLER_ * Once you're happy with it, delete the directories you unzipped and, then zip/tarball up the `SoarRelease` directory and upload to the release on GitHub. - `zip -r Soar-Release-.zip Soar-Release-` - `tar -czvf Soar-Release-.tar.gz Soar-Release-` +* Upload the Soar and VisualSoar manuals to the release, as well * Push a releases/$VERSION tag for Soar, and $VERSION tags for other Release-Support and VisualSoar. +* Update the Soar website with the new release information: https://github.com/SoarGroup/SoarGroup.github.io diff --git a/txt/Release_Notes_9.6.3.md b/txt/Release_Notes_9.6.3.md new file mode 100644 index 0000000..5dd5936 --- /dev/null +++ b/txt/Release_Notes_9.6.3.md @@ -0,0 +1,67 @@ +# Soar 9.6.3 Release Notes, 2024 + +This release of Soar includes TODO: summary here + +## Breaking Changes + +* New chunking setting, automatically-create-singletons, on by default + * In our work we've found that we usually want all attributes to be singletons by default unless explicitly specified otherwise. This setting attempts creating singletons for every string attribute. We expect this to be a saner default for all users, and think it unlikely to have a negative effect on existing projects. If you have a project that relies on non-singleton attributes, you can disable this setting by setting `chunking automatically-create-singletons off`. + +## New Features + +* TODO header + * TODO line item + * TODO line item + +## Other Changes + +* Bug fixes + * TODO + +* VisualSoar bug fixes (thanks to amnuxoll): + * TODO + +* Infrastructure improvements + * TODO + +* Cruft and cleanup + * TODO + +## General Information + +Soar can be downloaded by following the download link on the Soar home +page at: + + http://soar.eecs.umich.edu/articles/downloads/soar-suite + +Soar releases include source code, demo programs, and a number of +applications that serve as examples of how to interface Soar to an +external environment. There is support for integrating Soar with C++, +Java, Tcl and Python applications. Many tools that aid in development +of Soar programs are also available. The download section of the web site +allows you to browse and download all of the different distributions, +tools and agents. + +### Help and Contact information + +You can find many helpful resources on the Soar home page at: + + https://soar.eecs.umich.edu + +To contact the Soar group, you may join and post to one of our mailing +lists: + +For general Soar-related announcements: + + soar-group@lists.sourceforge.net + +For help: + + soar-help@lists.sourceforge.net + +Also, please do not hesitate to file bugs or feature requests on our issue +tracker at github: + + https://github.com/SoarGroup/Soar/issues + +To avoid redundant entries, please search for duplicate issues first.