From 14ca0576e8c43d9be3b9e5bfe02b2f0414df14b2 Mon Sep 17 00:00:00 2001
From: hayden-MB <hmaudsle@ed.ac.uk>
Date: Mon, 2 Dec 2024 11:18:52 +0000
Subject: [PATCH 1/3] updates to stats page

---
 doc/en/Topics/Statistics.md | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/doc/en/Topics/Statistics.md b/doc/en/Topics/Statistics.md
index 7293400bf3..2cbaa1e921 100644
--- a/doc/en/Topics/Statistics.md
+++ b/doc/en/Topics/Statistics.md
@@ -1,22 +1,23 @@
 # Statistics in STACK
 
-STACK was not designed with Statistics in mind. To assess statistics, we can of course use the algebraic tools, and standard support for [proofs/derivation](../Proof). However this is not the main concern in statistics education. So what can we do?
+STACK was not designed with Statistics in mind. To assess statistics, we can use the algebraic tools, and standard support for [proofs/derivation](Proof\index.md). However this is not the main concern in statistics education. This is intended as a guide to writing Statistics questions in STACK.
 ## Assessment approaches
 
 ### Code
 
-Another common assessment type in Statistics, is checking students' confidence in \(R\). It may be tempting to do this by asking students to input a string, but this is very hard to assess due to different interpretations of what is required, and different variable names. 
+Most statistics courses use programming in R or python. It may be tempting to assess code snippets by asking students to input a string, but this is very hard to assess due to different interpretations of what is required, and different variable names. 
 
-If you wish to assess code using a moodle quiz, this can be done using the [Coderunner question type](https://docs.moodle.org/405/en/CodeRunner_question_type). This question type allows students to write code which is assessed on its effectiveness on specified examples.
+If you wish to assess code using a Moodle quiz, this can be done using the [Coderunner question type](https://docs.moodle.org/405/en/CodeRunner_question_type). This question type allows students to write code which is assessed on its effectiveness on specified examples.
 
 ### Numerics
-However, we can assess the _results_ of \(R\) usage using STACK. Most teachers using STACK make use of randomisation, but this relies on Maxima's ability to calculate the correct answer. Maxima supports most short \(R\) functions. This section is intended to aid the translation of questions relying on commands in the statistical computing software \(R\) into STACK questions using Maxima. You do not need an in depth knowledge of statistics to use this.  
+However, we can assess the _results_ of statistical annalysis (such as in \(R\)). 
 
 
-#### R to Maxima
 
 
-Firstly, it is useful to know the translations for common R functions.
+Most teachers using STACK make use of randomisation, but this relies on Maxima's ability to calculate the correct answer. This section is intended to aid the translation of questions relying on commands in the statistical computing software \(R\) into STACK questions using Maxima. You do not need an in depth knowledge of statistics to use this.  
+
+#### Distribution functions
 
 STACK loads the "distrib" package from maxima by default. Check that your server in the plugin 'STACK' settings has `distrib` in the box `Load optional Maxima libraries`.
 
@@ -26,10 +27,7 @@ Mostly, it is simple to figure out the format of the maxima equivalent, however
 
 - For the function r* in \(R\), or random* in Maxima, the order of the inputs is different. 
 - Maxima and R have different default settings for the Gamma distribution. Maxima uses the shape and scale parameters, while R uses the shape and rate parameters. As such, be careful to translate.
-- R and maxima have different default settings for Variance (and by extension, standard deviation). `var(x)` in R will calculate the sample variance while maxima calculates the population variance. In maxima, `var1(x)` would be the equivalent to `var(x)` in R.
 - Data is expressed in a list in Maxima, thus `c(1,2,3)` translates to `[1,2,3]`.
-- In R, if no mean and standard deviation is provided, mean = 0 and standard deviation = 1. 
-
 
 
 <style>
@@ -138,7 +136,7 @@ table, th, td {
 <br>
 <br>
 
-From this, we can generally estimate what the translation will be, however let us consider a full list of distributions, including the inputs they take. **The <code>random_</code> version of these will of course be reversed.** 
+From this, we can generally estimate what the translation will be, however let us consider a full list of distributions, including the inputs they take. **The <code>random_</code> version of these will be reversed.** 
 
 <div class="divTable">
 <div class="divTableBody">
@@ -217,10 +215,14 @@ From this, we can generally estimate what the translation will be, however let u
 </div>
 </div>
 
-
+<br>
 For detailed informaion on this see the [distrib package documentation](https://maths.cnam.fr/Membres/wilk/MathMax/help/Maxima/maxima_47.html). This also provides information on calculating skewness and kurtosis.
 
 ##### Mean variance and standard deviation
+
+###### Key points 
+- R and maxima have different default settings for Variance (and by extension, standard deviation). `var(x)` in R will calculate the sample variance while maxima calculates the population variance. In maxima, `var1(x)` would be the equivalent to `var(x)` in R.
+- In R, if no mean and standard deviation is provided, mean = 0 and standard deviation = 1. 
 <div class="divTable">
 <div class="divTableBody">
 <div class="divTableRow">

From b544152a85c619c07c24701c8b61abcfc1df6fa6 Mon Sep 17 00:00:00 2001
From: hayden-MB <hmaudsle@ed.ac.uk>
Date: Mon, 2 Dec 2024 11:24:07 +0000
Subject: [PATCH 2/3] small edits to stats.md

---
 doc/en/Topics/Statistics.md | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/doc/en/Topics/Statistics.md b/doc/en/Topics/Statistics.md
index 2cbaa1e921..4b5d9e8a39 100644
--- a/doc/en/Topics/Statistics.md
+++ b/doc/en/Topics/Statistics.md
@@ -260,21 +260,20 @@ For detailed informaion on this see the [distrib package documentation](https://
 </div>
 
 #### Useful other functions
-<ul>
-<li><code>binomial(n,k)</code> := \(\frac{n!}{k!(n-k)!}\)</li>
-<li><code>makelist(f(x),x,a,b)</code>:= list of f(x) from a to b.
-</ul>
-Variatations of make list are detailed in the maxima documention for lists.
 
+- <code>binomial(n,k)</code> := \( \frac{n!}{k!(n-k)!} \)
+- <code>makelist(f(x),x,a,b)</code>:= list of f(x) from a to b.
+
+Variatations of make list are detailed in the [Maxima documentation for lists](https://maxima.sourceforge.io/docs/manual/maxima_21.html).
 
 
 
-## Presenting information
-In statistics education, we may want to display R code or data. It can be tempting to take a screenshot and upload this, but it is better to use the `<pre>` environment to print this code. Alternatively, you can upload a file of data using the moodle link feature or [serving out data](..\Authoring\Serving_out_data.md).
 
+## Presenting information
+In statistics education, we may want to display R code or data. It can be tempting to take a screenshot and upload this, but it is better to use the `<pre>` environment to display this code as formatted in a code editor. Alternatively, you can upload a file of data using the Moodle link feature or [serving out data](..\Authoring\Serving_out_data.md).
 
 
-May be difficult for students to input some statistical notation so try to keep things simple or use an input type other than algebraic expression. STACK uses `\var<LETTER>{}` for greek letters, as such it is logical to use these versions in your questions, to ensure the validation a student view matches the question. 
+It may be difficult for students to input some statistical notation so try to keep things simple or use an input type other than algebraic expression. STACK uses `\var<LETTER>{}` for greek letters, as such it is logical to use these versions in your questions, to ensure the validation a student view matches the question. 
 ## General tips
 
 STACK may simplify when not appropriate for statistics. For instance, while \(\sigma^2\) is in fact the standard deviation squared, it is often not desired to simplify this in an expression. Consider this when writing algebraic questions or using question variables with `simp:true` on.
@@ -286,7 +285,7 @@ todo: sample var default in r, pop default in maxima
 
 ## Example 
 
-In our example, the student is asked find a confidence interval. We will randomly generate a data set for the student. This also includes [serving out data](..\Authoring\Serving_out_data.md).
+In this example, the student is asked find a confidence interval. We will randomly generate a data set for the student. This also includes [serving out data](..\Authoring\Serving_out_data.md).
 ### Question variables 
 
 

From 5eac55bcd67629f26c0f7300c9f7976d878427fc Mon Sep 17 00:00:00 2001
From: hayden-MB <hmaudsle@ed.ac.uk>
Date: Mon, 2 Dec 2024 12:08:14 +0000
Subject: [PATCH 3/3] remove todo

---
 doc/en/Topics/Statistics.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/en/Topics/Statistics.md b/doc/en/Topics/Statistics.md
index 4b5d9e8a39..86764a1865 100644
--- a/doc/en/Topics/Statistics.md
+++ b/doc/en/Topics/Statistics.md
@@ -281,7 +281,6 @@ STACK may simplify when not appropriate for statistics. For instance, while \(\s
 It is worth being careful with using `i` as a sum index. Maxima may interpret this as the imaginary number `i`.  
 
 
-todo: sample var default in r, pop default in maxima
 
 ## Example