update

Author: BatyLeo

docs/make.jl

@@ -32,9 +32,9 @@ makedocs(;
         "Tutorials" => include_tutorial ? md_tutorial_files : [],
         "Benchmark problems list" => [
             "benchmarks/subset_selection.md",
-            "benchmarks/portfolio_optimization.md",
             "benchmarks/fixed_size_shortest_path.md",
             "benchmarks/warcraft.md",
+            "benchmarks/portfolio_optimization.md",
         ],
         "API reference" =>
             ["api/interface.md", "api/decision_focused.md", "api/warcraft.md"],

docs/src/benchmarks/fixed_size_shortest_path.md

@@ -1,3 +1,4 @@
 # Shortest paths
 
-[`FixedSizeShortestPathBenchmark`](@ref)
+[`FixedSizeShortestPathBenchmark`](@ref) is a benchmark problem that consists of finding the shortest path in a grid graph between the top left and bottom right corners.
+In this benchmark, the grid size is the same for all instances.

docs/src/benchmarks/portfolio_optimization.md

@@ -1,3 +1,12 @@
 # Portfolio Optimization
 
-[`PortfolioOptimizationBenchmark`](@ref)
+[`PortfolioOptimizationBenchmark`](@ref) is a Markovitz portfolio optimization problem, where asset prices are unknown, and only contextual data is available to predict these prices.
+The goal is to predict asset prices $c$ and maximize the expected return of a portfolio, subject to a risk constraint using this maximization program:
+```math
+\begin{aligned}
+\max\quad & c^\top x\\
+\text{s.t.}\quad & x^\top \Sigma x \leq \gamma\\
+& 1^\top x \leq 1\\
+& x \geq 0
+\end{aligned}
+```

docs/src/benchmarks/subset_selection.md

@@ -10,4 +10,4 @@ We want to select a subset of ``k`` items that maximizes the sum of the values o
 As input, instead of the items costs, we are given a feature vector, such that an unknown linear mapping between the feature vector and the value of the items exists.
 
 By default, this linear mapping is the identity mapping, i.e., the value of each item is equal to the value of the corresponding feature vector element.
-However, this mapping can be changed by setting the `identity_mapping` parameter to false.
+However, this mapping can be changed by setting the `identity_mapping` parameter to `false`.

docs/src/benchmarks/warcraft.md

@@ -1,3 +1,3 @@
 # Warcraft
 
-[`WarcraftBenchmark`](@ref)
+See the tutorial for a full demo of [`WarcraftBenchmark`](@ref).