Add documentation about carps usage

CHANGELOG.md

@@ -1,6 +1,9 @@
 
 # v0.1.1
 
+## Documentation
+- Add example for the case when developing a standalone package either for a benchmark or for an optimizer (#157)
+
 ## Bug Fixes
 - Fix HEBO integration (#149)
 - Fix plotting and data gathering

README.md

@@ -158,6 +158,12 @@ guidelines for
 and
 [optimizers](https://automl.github.io/CARP-S/latest/contributing/contributing-an-optimizer/).
 
+## Using your (external) optimizer or benchmark
+In the case when you are developing your optimizer or benchmark in a standalone package, you can use carps without directly working in the carps repo.
+For a custom benchmark we have an [example repo](https://github.com/automl/OptBench).
+It shows how to use your own benchmark with carps optimizers.
+For a custom optimizer check this [example repo](https://github.com/automl/CARP-S-example-optimizer).
+Information is also available [here](https://automl.github.io/CARP-S/guides/using-carps/).
 
 ## Evaluation Results
 For each scenario (blackbox, multi-fidelity, multi-objective and multi-fidelity-multi-objective) and set (dev and test), we run selected optimizers and provide the data.

docs/guides/using-carps.md

@@ -0,0 +1,11 @@
+# Using Carps
+
+In the case when you are developing your optimizer or benchmark in a standalone package, you can use carps without directly working in the carps repo.
+
+## With your own benchmark
+For a custom benchmark we have an [example repo](https://github.com/automl/OptBench).
+It shows how to use your own benchmark with carps optimizers.
+
+## With your own optimizer
+When you develop your own optimizer, check this [example repo](https://github.com/automl/CARP-S-example-optimizer).
+It shows how to use your own optimizer with carps benchmarks.

mkdocs.yaml

@@ -188,6 +188,7 @@ nav:
     - "guides/database.md"
     - "guides/containers.md"
     - "guides/large-scale-benchmarking.md"
+    - "guides/using-carps.md"
   - Commands: "commands.md"
   - Contributing:
     - "contributing/index.md"