detailed README

README.md

-# scipopt-crossbuilder
+# scipopt crossbuilder
 
-A cross-compilation helper repository for the scipoptsuite, based on BinaryBuilder.jl
\ No newline at end of file
+A cross-compilation helper repository for the scipoptsuite, based on BinaryBuilder.jl.
+
+Requirements:
+- `julia` in your path, 1.6 is preferred
+- a repository with `scipoptsuite` to test.
+
+Basic usage:
+```
+./run_builder.sh path_to_scipoptsuite
+```
+
+Advanced usage:
+- Change the SCIP build script with the `script` variable of the Julia `build.jl` program
+- If you want to drop into the build environment when an error occurs, use the `debug` flag:
+
+```bash
+julia --project builder.jl --deploy=local --verbose --debug
+```
+
+## Documentation
+
+BinaryBuilder.jl documentation: https://docs.binarybuilder.org/latest/reference/#Command-Line  
+See all PRs associated to SCIP in the Julia build repository: https://github.com/JuliaPackaging/Yggdrasil/pulls?q=SCIP