Update notebook in line with review comments

Author: tsmbland

docs/user-guide/carbon-budget.ipynb

@@ -33,15 +33,15 @@
     "control_undershoot = false\n",
     "control_overshoot = false\n",
     "method = 'bisection'\n",
-    "method_options.sample_size = 5\n",
+    "method_options.max_iterations = 5\n",
     "method_options.tolerance = 0.2\n",
     "```\n",
     "\n",
     "We need a budget value for each year in the time framework. In this case we will impose a budget of 300 in every year. `control_undershoot` and `control_overshoot` allow a carbon surplus or deficit in one year to be carried over to the next year (which we will not allow in this case). We also need to give the name of the carbon commodity (matching a commodity defined in `GlobalCommodities.csv`), in this case `CO2f`. \n",
     "\n",
-    "The other lines indicate settings used in the carbon budget algorithm, which modifies the carbon price so that carbon emissions come as close as possible to the budget. The method we are using is the [bisection method](https://en.wikipedia.org/wiki/Bisection_method), which iteratively halves a carbon price interval until emissions are within tolerance of the target. `sample_size` and `tolerance` are parameters used in the bisection algorithm: `tolerance` controls how close emissions need to be to the budget (e.g. 20%) for the algorithm to converge on a solution; `sample_size` is the maximum number of carbon prices that will be tested. Reducing `tolerance` and increasing `sample_size` can help achieve emissions as close as possible to the budget, but the simulation may take much longer to run.\n",
+    "The other lines indicate settings used in the carbon budget algorithm, which modifies the carbon price so that carbon emissions come as close as possible to the budget. The method we are using is the [bisection method](https://en.wikipedia.org/wiki/Bisection_method), which iteratively halves a carbon price interval until emissions are within tolerance of the target. `max_iterations` and `tolerance` are parameters used in the bisection algorithm: `tolerance` controls how close emissions need to be to the budget (e.g. 20%) for the algorithm to converge on a solution; `max_iterations` is the maximum number of iterations before the algorithm terminates. Reducing `tolerance` and increasing `max_iterations` can help achieve emissions as close as possible to the budget, but the simulation may take much longer to run.\n",
     "\n",
-    "See [here](../inputs/toml.rst) for more details about carbon budget settings.\n",
+    "See [here](../inputs/toml.rst#carbon-market) for more details about carbon budget settings.\n",
     "\n",
     "Finally, since we want to look at commodity supply to monitor carbon emissions, we will also need to add the \"supply\" output, which will create a file called `MCASupply.csv` with supply values for each commodity in each timeslice/year:\n",
     "\n",