From 517c694407c3605653fc38748d4c5ab11b3a09f2 Mon Sep 17 00:00:00 2001 From: Chris Sangwin <C.J.Sangwin@ed.ac.uk> Date: Tue, 21 May 2024 15:26:19 +0100 Subject: [PATCH] Update docs and versions in anticipation of releasing v4.6.0. --- api/config_sample.txt | 4 ++-- api/docker/docker-compose.dev.yml | 2 +- api/docker/docker-compose.yml | 2 +- doc/en/Developer/Development_history.md | 16 ++++++++++++++++ doc/en/Developer/Development_track.md | 14 -------------- doc/en/Developer/Releasing.md | 8 +++++--- doc/en/Installation/STACK_versions.md | 1 + doc/en/Installation/index.md | 2 +- stack/maxima/stackmaxima.mac | 2 +- version.php | 4 ++-- 10 files changed, 30 insertions(+), 25 deletions(-) diff --git a/api/config_sample.txt b/api/config_sample.txt index 6e50708ac..c6c10ccc6 100644 --- a/api/config_sample.txt +++ b/api/config_sample.txt @@ -93,8 +93,8 @@ $CFG->inputmustverify = 1; $CFG->inputshowvalidation = 1; // These should match the version of goemaxima in docker-compose. -$CFG->stackmaximaversion = "2024012900"; -$CFG->version = "2024012900"; +$CFG->stackmaximaversion = "2024052100"; +$CFG->version = "2024052100"; // Do not change this setting. $CFG->mathsdisplay = 'api'; diff --git a/api/docker/docker-compose.dev.yml b/api/docker/docker-compose.dev.yml index 31c9252c7..18f87210b 100644 --- a/api/docker/docker-compose.dev.yml +++ b/api/docker/docker-compose.dev.yml @@ -1,7 +1,7 @@ version: "4.0" services: maxima: - image: mathinstitut/goemaxima:2024012900-latest + image: mathinstitut/goemaxima:2024052100-latest tmpfs: - "/tmp" restart: unless-stopped diff --git a/api/docker/docker-compose.yml b/api/docker/docker-compose.yml index 88d495bc0..6d0ba30df 100644 --- a/api/docker/docker-compose.yml +++ b/api/docker/docker-compose.yml @@ -1,7 +1,7 @@ version: "4.0" services: maxima: - image: mathinstitut/goemaxima:2024012900-latest + image: mathinstitut/goemaxima:2024052100-latest tmpfs: - "/tmp" restart: unless-stopped diff --git a/doc/en/Developer/Development_history.md b/doc/en/Developer/Development_history.md index da75a8ee9..73913a64b 100644 --- a/doc/en/Developer/Development_history.md +++ b/doc/en/Developer/Development_history.md @@ -2,6 +2,22 @@ For current and future plans, see [Development track](Development_track.md) and [Future plans](Future_plans.md). +## Version 4.6.0 + +Released May 2024. + +This version will require moodle 4.0+. Moodle 3.x is no longer supported. + +1. Alter list of acceptible expressions. Unicode super/subscripts now are invalid. Use 150_replace filter in students' input. +2. Add in the extra input option `feedback` to run in parallel with validators to give opportunities for bespoke messages. +3. Load the `functs` Maxima package, i.e. `load("functs");` to give access to some useful functions. +4. Fix display and simplification of binomial coefficients (issue #931). +5. Add in the `CT:...` and `RAW:...` options for test case construction to enable tests of invalid input (e.g. missing stars). +6. STACK now has an [API](../Installation/API.md) to provide STACK questions as a web service. +7. Improve the display of floats. Numbers of decimal places are now respected in all parts of expressions, and floats such as `1.7E-9` are displayed at \(1.7 \times 10^{-9}\). There is a new question option to choose between \(1.7 \times 10^{-9}\) and \(1.7E-9\). +8. Add in support for drag and drop [matching problems](../Authoring/Matching.md). + + ## Version 4.5.0-hf2 Fix critical bug in Javascript. diff --git a/doc/en/Developer/Development_track.md b/doc/en/Developer/Development_track.md index af1c62530..7c4550bc4 100644 --- a/doc/en/Developer/Development_track.md +++ b/doc/en/Developer/Development_track.md @@ -5,20 +5,6 @@ past development history is documented on [Development history](Development_hist We use the [github issue tracker](https://github.com/maths/moodle-qtype_stack/issues) to track "milestones". -## Version 4.6.0 - -This version will require moodle 4.0+. Moodle 3.x is no longer supported. - -1. Alter list of acceptible expressions. Unicode super/subscripts now are invalid. Use 150_replace filter in students' input. -2. Add in the extra input option `feedback` to run in parallel with validators to give opportunities for bespoke messages. -3. Load the `functs` Maxima package, i.e. `load("functs");` to give access to some useful functions. -4. Fix display and simplification of binomial coefficients (issue #931). -5. Add in the `CT:...` and `RAW:...` options for test case construction to enable tests of invalid input (e.g. missing stars). -6. STACK now has an [API](../Installation/API.md) to provide STACK questions as a web service. -7. Improve the display of floats. Numbers of decimal places are now respected in all parts of expressions, and floats such as `1.7E-9` are displayed at \(1.7 \times 10^{-9}\). There is a new question option to choose between \(1.7 \times 10^{-9}\) and \(1.7E-9\). -8. Add in support for drag and drop [matching problems](../Authoring/Matching.md). - - ## Version 4.7.0 Issues with [github milestone 4.7.0](https://github.com/maths/moodle-qtype_stack/issues?q=is%3Aissue+milestone%3A4.7.0) include diff --git a/doc/en/Developer/Releasing.md b/doc/en/Developer/Releasing.md index 39dd36e40..5f481badd 100644 --- a/doc/en/Developer/Releasing.md +++ b/doc/en/Developer/Releasing.md @@ -42,13 +42,15 @@ Unless you want to discuss something confidential with the developers, please do * version.php * stackmaxima.mac - * Run `php cli/getversionstring.php` and add output to `doc/en/Installation/STACK_versions.md`. - * `MATURITY_STABLE`? - * Check both the Moodle versions, and the required number. (https://moodledev.io/general/releases) * Update version numbers in the API in anticipation of a new Goemaxima image `api/config_samples.txt` * Update Goemaxima docker image versions in `api/docker/docker-compose.dev.yml` and `api/docker/docker-compose.yml` E.g. see `https://hub.docker.com/r/mathinstitut/goemaxima` for latest versions. + + * Run `php cli/getversionstring.php` and add output to `doc/en/Installation/STACK_versions.md`. + * Change to `MATURITY_STABLE` in version.php + * Check both the Moodle versions, and the required number. (https://moodledev.io/general/releases) Update `Installation/index.md` + Commit all changes to git, e.g. "Update version number for the 4.6.0 release." ## 2. Create new tag with version name diff --git a/doc/en/Installation/STACK_versions.md b/doc/en/Installation/STACK_versions.md index 9a6a79464..ad2662107 100644 --- a/doc/en/Installation/STACK_versions.md +++ b/doc/en/Installation/STACK_versions.md @@ -9,6 +9,7 @@ when releasing. Release | Version number | Supported Maxima versions --------|----------------|-------------------------- +4.6.0 | 2024052100 | 5.40.0, 5.41.0, 5.42.0, 5.42.1, 5.42.2, 5.43.0, 5.43.1, 5.43.2, 5.44.0, 5.46.0, 5.47.0 4.5.0 | 2023121100 | 5.40.0, 5.41.0, 5.42.0, 5.42.1, 5.42.2, 5.43.0, 5.43.1, 5.43.2, 5.44.0, 5.46.0, 5.47.0 4.4.5 | 2023072101 | 5.40.0, 5.41.0, 5.42.0, 5.42.1, 5.42.2, 5.43.0, 5.43.1, 5.43.2, 5.44.0, 5.46.0, 5.47.0 4.4.4 | 2023060500 | 5.40.0, 5.41.0, 5.42.0, 5.42.1, 5.42.2, 5.43.0, 5.43.1, 5.43.2, 5.44.0 diff --git a/doc/en/Installation/index.md b/doc/en/Installation/index.md index 6ea35cb2a..8fa39b39c 100644 --- a/doc/en/Installation/index.md +++ b/doc/en/Installation/index.md @@ -2,7 +2,7 @@ STACK is being used live at many institutions, including the University of Edinburgh, the UK Open University, Aalto, Loughborough University, and the University of Birmingham in the UK. -We appreciate some people prefer hosted services as an alternative to running their own server. We are pleased to work with EDINA at the University of Edinburgh as a [recommended hosting partner](https://stack.edina.ac.uk/). +We appreciate some people prefer hosted services as an alternative to running their own server. If so, then please contact the developers for more details of current providers. STACK is designed to be used on a Linux-based server. The Windows/MS option exists to help teachers author questions offline, and for demonstration and development. However, for demonstration, development and offline use we strongly recommend using VirtualBox instead of the Windows port. Note also that support for the optimized Maxima image is not available on Windows platforms, which is a substantial performance improvement. diff --git a/stack/maxima/stackmaxima.mac b/stack/maxima/stackmaxima.mac index c41663ff8..996f2de50 100644 --- a/stack/maxima/stackmaxima.mac +++ b/stack/maxima/stackmaxima.mac @@ -3334,4 +3334,4 @@ is_lang(code):=ev(is(%_STACK_LANG=code),simp=true)$ /* Stack expects some output with the version number the output happens at */ /* maximalocal.mac after additional library loading */ -stackmaximaversion:2024050600$ +stackmaximaversion:2024052100$ diff --git a/version.php b/version.php index 88419d4d5..d4df77141 100644 --- a/version.php +++ b/version.php @@ -24,11 +24,11 @@ defined('MOODLE_INTERNAL') || die(); -$plugin->version = 2024050600; +$plugin->version = 2024052100; $plugin->requires = 2022041900; $plugin->cron = 0; $plugin->component = 'qtype_stack'; -$plugin->maturity = MATURITY_ALPHA; +$plugin->maturity = MATURITY_STABLE; $plugin->release = '4.6.0 for Moodle 4.0+'; $plugin->dependencies = [ -- GitLab