Open SaySayo opened 8 months ago
Hi, I'm Pranay. My initial application for outreachy is accepted. I'm interested in working on this project. I am going through the given instructions above and have installed OCaml on Ubuntu. The link of "exercises to practice" is not working.
Hello @pranayrauni, Welcome! Can I ask what link you're referring to? If you want to learn more about the ocaml language, you can find link to the tutorials here
Thank you @SaySayo for this guide. I'm currently setting up my development environment and look forward to asking questions and contributing successfully too.
Hello @pranayrauni, Welcome! Can I ask what link you're referring to? If you want to learn more about the ocaml language, you can find link to the tutorials here
Here is the link: https://ocaml.org/problems
Oh... I see, @pranayrauni Problems have been renamed to exercises, so you can try accessing it from here https://ocaml.org/exercises
@SaySayo the link to exercises have been updated to https://ocaml.org/exercises, can you please help update it in case others encounter this issue
Oh... I see, @pranayrauni Problems have been renamed to exercises, so you can try accessing it from here https://ocaml.org/exercises
Thank you very much
okay @pranayrauni or @SaySayo or @Aquilaafuadajo I'm unable to run; bash < <(curl -sL https://ocaml.org/install-platform.sh) successfully.
I get a response error of;
bash: line 1: syntax error near unexpected token newline' bash: line 1:
<!DOCTYPE html>'
What I'm I missing? Thanks.
Hello @SaySayo I'm Sobia Aman from Pakistan. I'm interested in Ocaml projectand want to contribute in it. I'm just landed here and now trying to setup Ocaml environment locally :)
Welcome @SobiaAman, if you need any help with setup and tasks you can drop them here or in the discord channel
@Aquilaafuadajo are you able to help me with the installation issue I'm facing as indicated above?
Thanks @Aquilaafuadajo will let you know if i need any help, Thanks for asking :)
Anyone please share the link of discord channel as well.
hello @SobiaAman , have you been able to install on Linux
@jahielkomu not yet i'm getting error which you're getting
(ocaml) zakia@DESKTOP-I2B0R5O:~$ bash < <(curl -sL https://ocaml.org/install-platform.sh)
bash: line 1: syntax error near unexpected token newline' bash: line 1:
<!DOCTYPE html>'
Did you resolved the issue? why this link https://ocaml.org/install-platform.sh
gives 404 error?
No I haven't yet @SobiaAman . I'm hoping for any guidance from @SaySayo or those who have gone past that point.
Hello @SaySayo @Aquilaafuadajo i'm stuck at bash < <(curl -sL https://ocaml.org/install-platform.sh)
it gives me an error
bash: line 1: syntax error near unexpected token `newline'
bash: line 1: `<!DOCTYPE html>'
Secondly i tried to access the shell script but it is not available at https://ocaml.org/install-platform.sh
hence it returns 404 error. Kindly help me in this regard.
Thanks
That is exactly the same thing on my end @SobiaAman
Hi @SobiaAman @jahielkomu
Can you try following the guide here https://ocaml.org/docs/installing-ocaml#install-platform-tools to set up your environment
When through, confirm your OCaml and opam installation by running ocaml --version
and opam --version
respectively.
If confirmed, follow the guide on HACKING and README to run the project.
Let us know if you encounter any error along the line
I have installed the setup succesfully, finally up and running Ocaml on my WSL2 (ubuntu 20.-04) . Can someone let me know what to do after that, running the exercises or go to good-first issue as i want to apply in "Run OCaml Exercises Everywhere". I'm comparatively new to Ocaml but eager to learn Ocaml.
i have joined outreachy discord channel but strangly nobody is there, am i missing something?? Can someone help
Hi everyone, my name is Mucha, I am a full stack dev from Kenya, happy to be here as part of Outreachy24
here
W
Hi everyone, my name is Mucha, I am a full stack dev from Kenya, happy to be here as part of Outreachy24
Welcome Mucha, it's nice having you here
Welcome everyone! Are you still having installation issues? @jahielkomu @SobiaAman, did you also join the specific outreachy channel on discord?
@SobiaAman Picking a good first issue
would be the best next step.
Indicate interest in an issue you want to try out and wait for a confirmation to go ahead and work on it from the mentors or maintainers
Hi @SobiaAman @jahielkomu Can you try following the guide here https://ocaml.org/docs/installing-ocaml#install-platform-tools to set up your environment When through, confirm your OCaml and opam installation by running
ocaml --version
andopam --version
respectively. If confirmed, follow the guide on HACKING and README to run the project. Let us know if you encounter any error along the line
Thank you for this guide, I have successfully installed and I'm running it locally.
Hello, I have been able to setup and currently running ocaml locally.
Hello everyone, my name is Wisdom, I am happy to be here as part of Outreachy24
Hi @SaySayo, I am Stella Ugoo-Okonkwo an Outreachy applicant and am happy to be here. I am interested in contributing to this project and currently am going through the above instructions to enable me make a good contribution.
Hello Everyone! I am Ayushi, an Outreachy applicant from India. I am so excited to be here to collaborate with you all and make amazing contributions!
Hello everyone! I am Jennifer, an Outreachy applicant from Nigeria. I am excited to be here to learn and collaborate.
Hi @SaySayo,
I'm looking for good first issues to contribute to the project. I noticed there aren't any listed in the issues tab. Would you be open to adding some easy-to-fix bugs or small feature requests that new contributors could tackle? Or should we wait and see if any issues are reported by users or contributors as they explore the project?
Welcome everyone! Are you still having installation issues? @jahielkomu @SobiaAman, did you also join the specific outreachy channel on discord?
Hello @SaySayo , I have been successful in joining the channels. Thank you
Hi @SaySayo,
I'm looking for good first issues to contribute to the project. I noticed there aren't any listed in the issues tab. Would you be open to adding some easy-to-fix bugs or small feature requests that new contributors could tackle? Or should we wait and see if any issues are reported by users or contributors as they explore the project?
Hi @ayushichoudhary-19 have you checked this link new issues
Hi everyone, I'm Michael an applicant from Lagos Nigeria, I'm super excited to join this team of wonderful techies in this round of outreachy internship. I hope to learn a lot from you all and also to give in my best. I know my joining is a little late, but I still hope to make the most out of this wonderful opportunity to co-learn with some amazing teammates. Of course, it's a great pleasure to learn under the mentorship of our boss @SaySayo and I know the whole process is going to be a smooth sail.
Good day @SaySayo I encountered this error trying to run the second command on my terminal. I use WSL2 on windows. Pls I need help from anyone who has been able to successfully set up and make the required installations.
Hello @SaySayo
I am facing some errors while run the command make switch
make switch
opam switch create . 4.14.1 --no-install --repos pin=git+https://github.com/ocaml/opam-repository#8cc107f96e33a4601f7c39346eb19fbbe46486d3
Creating repository pin...
[pin] Initialised
pin (at git+https://github.com/ocaml/opam-repository#8cc107f96e33a4601f7c39346eb19fbbe46486d3):
[WARNING] opam is out-of-date. Please consider updating it (https://opam.ocaml.org/doc/Install.html)
<><> Installing new switch packages <><><><><><><><><><><><><><><><><><><><><><>
Switch invariant: ["ocaml-base-compiler" {= "4.14.1"} | "ocaml-system" {= "4.14.1"}]
<><> Processing actions <><><><><><><><><><><><><><><><><><><><><><><><><><><><>
∗ installed base-bigarray.base
∗ installed base-threads.base
∗ installed base-unix.base
∗ installed ocaml-options-vanilla.1
⬇ retrieved ocaml-base-compiler.4.14.1 (https://github.com/ocaml/ocaml/archive/4.14.1.tar.gz)
∗ installed ocaml-base-compiler.4.14.1
∗ installed ocaml-config.2
∗ installed ocaml.4.14.1
Done.
# Run eval $(opam env) to update the current shell environment
opam install -y ocamlformat=0.25.1 ocaml-lsp-server
The following actions will be performed:
∗ install cmdliner 1.2.0 [required by ocamlformat]
∗ install ocamlfind 1.9.6 [required by uutf]
∗ install seq base [required by re]
∗ install ocamlbuild 0.14.2 [required by uutf]
∗ install dune 3.11.1 [required by ocaml-lsp-server, ocamlformat]
∗ install base-bytes base [required by ocp-indent]
∗ install topkg 1.0.7 [required by uutf]
∗ install xdg 3.11.1 [required by ocaml-lsp-server]
∗ install spawn v0.15.1 [required by ocaml-lsp-server]
∗ install sexplib0 v0.16.0 [required by base]
∗ install result 1.5 [required by odoc-parser, ocamlformat-lib]
∗ install re 1.11.0 [required by ocaml-lsp-server, ocamlformat]
∗ install pp 1.2.0 [required by ocaml-lsp-server]
∗ install ordering 3.11.1 [required by ocaml-lsp-server]
∗ install ocaml-version 3.6.2 [required by ocamlformat-lib]
∗ install menhirSdk 20230608 [required by ocamlformat-lib]
∗ install menhirLib 20230608 [required by ocamlformat-lib]
∗ install fix 20230505 [required by ocamlformat-lib]
∗ install either 1.0.0 [required by ocamlformat-lib]
∗ install dune-build-info 3.11.1 [required by ocaml-lsp-server]
∗ install csexp 1.5.2 [required by ocaml-lsp-server]
∗ install cppo 1.6.9 [required by yojson]
∗ install chrome-trace 3.11.1 [required by ocaml-lsp-server]
∗ install camlp-streams 5.0.1 [required by odoc-parser, ocamlformat-lib]
∗ install ocp-indent 1.8.1 [required by ocamlformat-lib]
∗ install uutf 1.0.3 [required by ocaml-lsp-server]
∗ install uucp 15.1.0 [required by uuseg]
∗ install astring 0.8.5 [required by odoc-parser, ocamlformat-lib]
∗ install dyn 3.11.1 [required by ocaml-lsp-server]
∗ install menhir 20230608 [required by ocamlformat-lib]
∗ install ocamlformat-rpc-lib 0.26.1 [required by ocaml-lsp-server]
∗ install merlin-lib 4.12-414 [required by ocaml-lsp-server]
∗ install dune-configurator 3.11.1 [required by base]
∗ install yojson 2.1.1 [required by ocaml-lsp-server]
∗ install uuseg 15.1.0 [required by ocamlformat-lib]
∗ install odoc-parser 2.0.0 [required by ocaml-lsp-server]
∗ install fpath 0.7.3 [required by ocamlformat-lib]
∗ install stdune 3.11.1 [required by ocaml-lsp-server]
∗ install ocamlc-loc 3.11.1 [required by ocaml-lsp-server]
∗ install base v0.16.3 [required by ocamlformat-lib]
∗ install ppx_yojson_conv_lib v0.16.0 [required by ocaml-lsp-server]
∗ install fiber 3.7.0 [required by ocaml-lsp-server]
∗ install dune-rpc 3.11.1 [required by ocaml-lsp-server]
∗ install stdio v0.16.0 [required by ocamlformat-lib]
∗ install ocaml-lsp-server 1.16.2
∗ install ocamlformat-lib 0.25.1 [required by ocamlformat]
∗ install ocamlformat 0.25.1
===== ∗ 47 =====
<><> Processing actions <><><><><><><><><><><><><><><><><><><><><><><><><><><><>
⬇ retrieved camlp-streams.5.0.1 (cached)
⬇ retrieved astring.0.8.5 (cached)
⬇ retrieved cmdliner.1.2.0 (cached)
⬇ retrieved cppo.1.6.9 (cached)
⬇ retrieved csexp.1.5.2 (cached)
⬇ retrieved base.v0.16.3 (https://github.com/janestreet/base/archive/refs/tags/v0.16.3.tar.gz)
∗ installed cmdliner.1.2.0
⬇ retrieved chrome-trace.3.11.1 (https://github.com/ocaml/dune/releases/download/3.11.1/dune-3.11.1.tbz)
⬇ retrieved dune-configurator.3.11.1 (cached)
⬇ retrieved dune-rpc.3.11.1 (cached)
⬇ retrieved dyn.3.11.1 (cached)
⬇ retrieved either.1.0.0 (cached)
⬇ retrieved fiber.3.7.0 (cached)
⬇ retrieved fix.20230505 (cached)
⬇ retrieved fpath.0.7.3 (cached)
⬇ retrieved dune-build-info.3.11.1 (https://github.com/ocaml/dune/releases/download/3.11.1/dune-3.11.1.tbz)
⬇ retrieved dune.3.11.1 (https://github.com/ocaml/dune/releases/download/3.11.1/dune-3.11.1.tbz)
⬇ retrieved menhirLib.20230608 (https://gitlab.inria.fr/fpottier/menhir/-/archive/20230608/archive.tar.gz)
⬇ retrieved menhirSdk.20230608 (https://gitlab.inria.fr/fpottier/menhir/-/archive/20230608/archive.tar.gz)
⬇ retrieved menhir.20230608 (https://gitlab.inria.fr/fpottier/menhir/-/archive/20230608/archive.tar.gz)
⬇ retrieved ocaml-version.3.6.2 (https://github.com/ocurrent/ocaml-version/releases/download/v3.6.2/ocaml-version-3.6.2.tbz)
∗ installed dune.3.11.1
⬇ retrieved ocaml-lsp-server.1.16.2 (https://github.com/ocaml/ocaml-lsp/releases/download/1.16.2/lsp-1.16.2.tbz)
∗ installed camlp-streams.5.0.1
∗ installed csexp.1.5.2
∗ installed either.1.0.0
∗ installed fix.20230505
∗ installed cppo.1.6.9
⬇ retrieved ocamlc-loc.3.11.1 (cached)
∗ installed menhirLib.20230608
∗ installed menhirSdk.20230608
∗ installed chrome-trace.3.11.1
∗ installed dune-build-info.3.11.1
⬇ retrieved merlin-lib.4.12-414 (https://github.com/ocaml/merlin/releases/download/v4.12-414/merlin-4.12-414.tbz)
⬇ retrieved ocamlbuild.0.14.2 (https://github.com/ocaml/ocamlbuild/archive/refs/tags/0.14.2.tar.gz)
∗ installed ocaml-version.3.6.2
⬇ retrieved ocamlfind.1.9.6 (cached)
⬇ retrieved ocamlformat-rpc-lib.0.26.1 (cached)
⬇ retrieved ocp-indent.1.8.1 (cached)
∗ installed ocamlformat-rpc-lib.0.26.1
⬇ retrieved odoc-parser.2.0.0 (https://github.com/ocaml-doc/odoc-parser/releases/download/2.0.0/odoc-parser-2.0.0.tbz)
∗ installed dune-configurator.3.11.1
⬇ retrieved ordering.3.11.1 (cached)
⬇ retrieved pp.1.2.0 (cached)
⬇ retrieved ocamlformat.0.25.1 (https://github.com/ocaml-ppx/ocamlformat/releases/download/0.25.1/ocamlformat-0.25.1.tbz)
⬇ retrieved ocamlformat-lib.0.25.1 (https://github.com/ocaml-ppx/ocamlformat/releases/download/0.25.1/ocamlformat-0.25.1.tbz)
[ERROR] Failed to get sources of ppx_yojson_conv_lib.v0.16.0: Curl failed
⬇ retrieved re.1.11.0 (cached)
⬇ retrieved result.1.5 (cached)
⬇ retrieved spawn.v0.15.1 (cached)
[ERROR] Failed to get sources of sexplib0.v0.16.0: Curl failed
[ERROR] Failed to get sources of stdio.v0.16.0: Curl failed
⬇ retrieved topkg.1.0.7 (cached)
∗ installed ocamlfind.1.9.6
∗ installed base-bytes.base
∗ installed pp.1.2.0
∗ installed seq.base
∗ installed result.1.5
∗ installed spawn.v0.15.1
∗ installed ordering.3.11.1
⬇ retrieved stdune.3.11.1 (cached)
∗ installed re.1.11.0
⬇ retrieved uutf.1.0.3 (cached)
⬇ retrieved uuseg.15.1.0 (https://erratique.ch/software/uuseg/releases/uuseg-15.1.0.tbz)
⬇ retrieved uucp.15.1.0 (https://erratique.ch/software/uucp/releases/uucp-15.1.0.tbz)
∗ installed ocp-indent.1.8.1
∗ installed ocamlbuild.0.14.2
⬇ retrieved xdg.3.11.1 (cached)
∗ installed dyn.3.11.1
⬇ retrieved yojson.2.1.1 (https://github.com/ocaml-community/yojson/releases/download/2.1.1/yojson-2.1.1.tbz)
∗ installed xdg.3.11.1
∗ installed ocamlc-loc.3.11.1
∗ installed yojson.2.1.1
∗ installed topkg.1.0.7
∗ installed stdune.3.11.1
∗ installed uutf.1.0.3
∗ installed astring.0.8.5
∗ installed fiber.3.7.0
∗ installed odoc-parser.2.0.0
∗ installed merlin-lib.4.12-414
∗ installed fpath.0.7.3
∗ installed dune-rpc.3.11.1
∗ installed menhir.20230608
∗ installed uucp.15.1.0
∗ installed uuseg.15.1.0
#=== ERROR while fetching sources for stdio.v0.16.0 ===========================#
OpamSolution.Fetch_fail("https://ocaml.janestreet.com/ocaml-core/v0.16/files/stdio-v0.16.0.tar.gz (Curl failed: \"/usr/bin/curl --write-out %{http_code}\\\\n --retry 3 --retry-delay 2 --user-agent opam/2.1.2 -L -o /home/sravanpant/OpenSource/ocaml.org/_opam/.opam-switch/sources/stdio.v0.16.0/stdio-v0.16.0.tar.gz.part -- https://ocaml.janestreet.com/ocaml-core/v0.16/files/stdio-v0.16.0.tar.gz\" exited with code 60)")
#=== ERROR while fetching sources for sexplib0.v0.16.0 ========================#
OpamSolution.Fetch_fail("https://ocaml.janestreet.com/ocaml-core/v0.16/files/sexplib0-v0.16.0.tar.gz (Curl failed: \"/usr/bin/curl --write-out %{http_code}\\\\n --retry 3 --retry-delay 2 --user-agent opam/2.1.2 -L -o /home/sravanpant/OpenSource/ocaml.org/_opam/.opam-switch/sources/sexplib0.v0.16.0/sexplib0-v0.16.0.tar.gz.part -- https://ocaml.janestreet.com/ocaml-core/v0.16/files/sexplib0-v0.16.0.tar.gz\" exited with code 60)")
#=== ERROR while fetching sources for ppx_yojson_conv_lib.v0.16.0 =============#
OpamSolution.Fetch_fail("https://ocaml.janestreet.com/ocaml-core/v0.16/files/ppx_yojson_conv_lib-v0.16.0.tar.gz (Curl failed: \"/usr/bin/curl --write-out %{http_code}\\\\n --retry 3 --retry-delay 2 --user-agent opam/2.1.2 -L -o /home/sravanpant/OpenSource/ocaml.org/_opam/.opam-switch/sources/ppx_yojson_conv_lib.v0.16.0/ppx_yojson_conv_lib-v0.16.0.tar.gz.part -- https://ocaml.janestreet.com/ocaml-core/v0.16/files/ppx_yojson_conv_lib-v0.16.0.tar.gz\" exited with code 60)")
<><> Error report <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
┌─ The following actions failed
│ ⬇ fetch ppx_yojson_conv_lib v0.16.0
│ ⬇ fetch sexplib0 v0.16.0
│ ⬇ fetch stdio v0.16.0
└─
┌─ The following changes have been performed (the rest was aborted)
│ ∗ install astring 0.8.5
│ ∗ install base-bytes base
│ ∗ install camlp-streams 5.0.1
│ ∗ install chrome-trace 3.11.1
│ ∗ install cmdliner 1.2.0
│ ∗ install cppo 1.6.9
│ ∗ install csexp 1.5.2
│ ∗ install dune 3.11.1
│ ∗ install dune-build-info 3.11.1
│ ∗ install dune-configurator 3.11.1
│ ∗ install dune-rpc 3.11.1
│ ∗ install dyn 3.11.1
│ ∗ install either 1.0.0
│ ∗ install fiber 3.7.0
│ ∗ install fix 20230505
│ ∗ install fpath 0.7.3
│ ∗ install menhir 20230608
│ ∗ install menhirLib 20230608
│ ∗ install menhirSdk 20230608
│ ∗ install merlin-lib 4.12-414
│ ∗ install ocaml-version 3.6.2
│ ∗ install ocamlbuild 0.14.2
│ ∗ install ocamlc-loc 3.11.1
│ ∗ install ocamlfind 1.9.6
│ ∗ install ocamlformat-rpc-lib 0.26.1
│ ∗ install ocp-indent 1.8.1
│ ∗ install odoc-parser 2.0.0
│ ∗ install ordering 3.11.1
│ ∗ install pp 1.2.0
│ ∗ install re 1.11.0
│ ∗ install result 1.5
│ ∗ install seq base
│ ∗ install spawn v0.15.1
│ ∗ install stdune 3.11.1
│ ∗ install topkg 1.0.7
│ ∗ install uucp 15.1.0
│ ∗ install uuseg 15.1.0
│ ∗ install uutf 1.0.3
│ ∗ install xdg 3.11.1
│ ∗ install yojson 2.1.1
└─
<><> ocp-indent.1.8.1 installed successfully ><><><><><><><><><><><><><><><><><>
=> This package requires additional configuration for use in editors. Install package 'user-setup', or manually:
* for Emacs, add these lines to ~/.emacs:
(add-to-list 'load-path "/home/sravanpant/OpenSource/ocaml.org/_opam/share/emacs/site-lisp")
(require 'ocp-indent)
* for Vim, add this line to ~/.vimrc:
set rtp^="/home/sravanpant/OpenSource/ocaml.org/_opam/share/ocp-indent/vim"
# Run eval $(opam env) to update the current shell environment
The former state can be restored with:
/usr/bin/opam switch import "/home/sravanpant/OpenSource/ocaml.org/_opam/.opam-switch/backup/state-20240308093515.export"
make: *** [Makefile:9: deps] Error 40
and hence I am not able to load the website using the command make start
and am facing some errors
make start
opam exec -- dune build --root .
File "src/ocamlorg_package/test/dune", line 3, characters 12-20:
3 | (libraries alcotest ocamlorg_package))
^^^^^^^^
Error: Library "alcotest" not found.
-> required by _build/default/src/ocamlorg_package/test/package_info_test.exe
-> required by alias src/ocamlorg_package/test/all
-> required by alias default
File "src/ocamlorg_web/lib/dune", line 13, characters 2-15:
13 | mirage-kv-mem))
^^^^^^^^^^^^^
Error: Library "mirage-kv-mem" not found.
-> required by library "ocamlorg_web" in _build/default/src/ocamlorg_web/lib
-> required by executable main in src/ocamlorg_web/bin/dune:2
-> required by _build/default/src/ocamlorg_web/bin/main.exe
-> required by _build/install/default/bin/server
-> required by _build/default/ocamlorg.install
-> required by alias all
-> required by alias default
File "src/ocamlorg_web/test/dune", line 3, characters 12-20:
3 | (libraries alcotest ocamlorg_web))
^^^^^^^^
Error: Library "alcotest" not found.
-> required by _build/default/src/ocamlorg_web/test/graphql_test.exe
-> required by alias src/ocamlorg_web/test/all
-> required by alias default
File "tool/ood-gen/lib/dune", line 20, characters 2-8:
20 | hilite
^^^^^^
Error: Library "hilite" not found.
-> required by library "ood_gen" in _build/default/tool/ood-gen/lib
-> required by executable gen in tool/ood-gen/bin/dune:2
-> required by _build/default/tool/ood-gen/bin/gen.exe
-> required by _build/default/asset/changelog.xml
-> required by alias asset/all
-> required by alias default
File "tool/ood-gen/test/dune", line 3, characters 12-20:
3 | (libraries alcotest ood_gen))
^^^^^^^^
Error: Library "alcotest" not found.
-> required by _build/default/tool/ood-gen/test/test_ood_gen.exe
-> required by alias tool/ood-gen/test/all
-> required by alias default
File "tool/ood-gen/bin/dune", line 14, characters 17-24:
14 | (libraries yaml ezjsonm ood_gen))
^^^^^^^
Error: Library "ezjsonm" not found.
-> required by _build/default/tool/ood-gen/bin/watch_scrape.exe
-> required by alias tool/ood-gen/bin/all
-> required by alias default
File "dune", line 12, characters 9-20:
12 | (run tailwindcss -m -c %{config} -i %{input} -o %{target})))))
^^^^^^^^^^^
Error: Program tailwindcss not found in the tree or in PATH
(context: default)
File "tool/ood-gen/lib/dune", line 23, characters 7-24:
23 | (pps ppx_deriving_yaml ppx_stable ppx_show)))
^^^^^^^^^^^^^^^^^
Error: Library "ppx_deriving_yaml" not found.
-> required by _build/default/tool/ood-gen/lib/academic_institution.pp.ml
-> required by alias tool/ood-gen/lib/all
-> required by alias default
File "src/ocamlorg_frontend/dune", line 3, characters 48-56:
3 | (libraries ocamlorg.global dream ocamlorg.data timedesc ocamlorg_static))
^^^^^^^^
Error: Library "timedesc" not found.
-> required by library "ocamlorg_frontend" in
_build/default/src/ocamlorg_frontend
-> required by
_build/default/src/ocamlorg_frontend/.ocamlorg_frontend.objs/byte/ocamlorg_frontend.cmo
-> required by _build/default/src/ocamlorg_frontend/ocamlorg_frontend.cma
-> required by alias src/ocamlorg_frontend/all
-> required by alias default
File "src/ocamlorg_package/lib/dune", line 13, characters 2-17:
13 | cohttp-lwt-unix
^^^^^^^^^^^^^^^
Error: Library "cohttp-lwt-unix" not found.
-> required by library "ocamlorg_package" in
_build/default/src/ocamlorg_package/lib
-> required by
_build/default/src/ocamlorg_package/lib/.ocamlorg_package.objs/byte/ocamlorg_package.cmo
-> required by _build/default/src/ocamlorg_package/lib/ocamlorg_package.cma
-> required by alias src/ocamlorg_package/lib/all
-> required by alias default
File "src/ocamlorg_static/dune", line 3, characters 16-21:
3 | (libraries fmt dream))
^^^^^
Error: Library "dream" not found.
-> required by library "ocamlorg_static" in
_build/default/src/ocamlorg_static
-> required by
_build/default/src/ocamlorg_static/.ocamlorg_static.objs/byte/ocamlorg_static.cmo
-> required by _build/default/src/ocamlorg_static/ocamlorg_static.cma
-> required by alias src/ocamlorg_static/all
-> required by alias default
File "src/ocamlorg_static/dune", line 15, characters 8-27:
15 | (run %{bin:ocaml-crunch} -m plain %{workspace_root}/asset -o %{target}))))
^^^^^^^^^^^^^^^^^^^
Error: Program ocaml-crunch not found in the tree or in PATH
(context: default)
File "src/ocamlorg_static/dune", line 25, characters 4-23:
25 | %{bin:ocaml-crunch}
^^^^^^^^^^^^^^^^^^^
Error: Program ocaml-crunch not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 251, characters 4-20:
251 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 17, characters 4-20:
17 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 43, characters 8-24:
43 | (run %{bin:dream_eml} %{dep:about.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 258, characters 8-24:
258 | (run %{bin:dream_eml} %{dep:footer.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 262, characters 8-24:
262 | (run %{bin:dream_eml} %{dep:forms.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 266, characters 8-24:
266 | (run %{bin:dream_eml} %{dep:header.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 271, characters 4-20:
271 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 294, characters 8-24:
294 | (run %{bin:dream_eml} %{dep:icons.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 307, characters 4-20:
307 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 278, characters 8-24:
278 | (run %{bin:dream_eml} %{dep:navmap.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 299, characters 4-20:
299 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 282, characters 8-24:
282 | (run %{bin:dream_eml} %{dep:pagination.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 286, characters 8-24:
286 | (run %{bin:dream_eml} %{dep:search.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 290, characters 8-24:
290 | (run %{bin:dream_eml} %{dep:toc.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 315, characters 4-20:
315 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 12, characters 8-24:
12 | (run %{bin:dream_eml} %{dep:layout.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 25, characters 4-20:
25 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 33, characters 4-20:
33 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 48, characters 4-20:
48 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 63, characters 8-24:
63 | (run %{bin:dream_eml} %{dep:blog.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 67, characters 8-24:
67 | (run %{bin:dream_eml} %{dep:blog_post.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 91, characters 8-24:
91 | (run %{bin:dream_eml} %{dep:books.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 71, characters 8-24:
71 | (run %{bin:dream_eml} %{dep:changelog.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 76, characters 4-20:
76 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 95, characters 8-24:
95 | (run %{bin:dream_eml} %{dep:community.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 187, characters 8-24:
187 | (run %{bin:dream_eml} %{dep:exercises.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 196, characters 8-24:
196 | (run %{bin:dream_eml} %{deps} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 201, characters 8-24:
201 | (run %{bin:dream_eml} %{deps} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 103, characters 8-24:
103 | (run %{bin:dream_eml} %{dep:home.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 108, characters 4-20:
108 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 123, characters 8-24:
123 | (run %{bin:dream_eml} %{dep:install.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 56, characters 4-20:
56 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 131, characters 8-24:
131 | (run %{bin:dream_eml} %{dep:jobs.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 115, characters 8-24:
115 | (run %{bin:dream_eml} %{dep:learn.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 119, characters 8-24:
119 | (run %{bin:dream_eml} %{dep:local_blog.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 243, characters 8-24:
243 | (run %{bin:dream_eml} %{dep:logos.eml} --workspace %{workspace_root}))))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 83, characters 8-24:
83 | (run %{bin:dream_eml} %{dep:news.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 87, characters 8-24:
87 | (run %{bin:dream_eml} %{dep:news_post.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 222, characters 8-24:
222 | (run %{bin:dream_eml} %{dep:not_found.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 135, characters 8-24:
135 | (run %{bin:dream_eml} %{dep:outreachy.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 148, characters 4-20:
148 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 227, characters 4-20:
227 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 140, characters 4-20:
140 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 156, characters 4-20:
156 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 163, characters 8-24:
163 | (run %{bin:dream_eml} %{dep:packages.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 168, characters 4-20:
168 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 176, characters 4-20:
176 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 238, characters 8-24:
238 | (run %{bin:dream_eml} %{dep:page.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 183, characters 8-24:
183 | (run %{bin:dream_eml} %{dep:papers.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 127, characters 8-24:
127 | (run %{bin:dream_eml} %{dep:platform.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 234, characters 8-24:
234 | (run %{bin:dream_eml} %{dep:playground.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 191, characters 8-24:
191 | (run %{bin:dream_eml} %{dep:release.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 206, characters 8-24:
206 | (run %{bin:dream_eml} %{dep:releases.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 211, characters 4-20:
211 | %{bin:dream_eml}
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 218, characters 8-24:
218 | (run %{bin:dream_eml} %{dep:tutorial.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
File "src/ocamlorg_frontend/dune", line 99, characters 8-24:
99 | (run %{bin:dream_eml} %{dep:workshop.eml} --workspace %{workspace_root})))
^^^^^^^^^^^^^^^^
Error: Program dream_eml not found in the tree or in PATH
(context: default)
make: *** [Makefile:5: all] Error 1
Pls help me with this issue
I have installed the setup succesfully, finally up and running Ocaml on my WSL2 (ubuntu 20.-04) . Can someone let me know what to do after that, running the exercises or go to good-first issue as i want to apply in "Run OCaml Exercises Everywhere". I'm comparatively new to Ocaml but eager to learn Ocaml.
Good day, Pls I ran into an issue running the second command on my WSL2, can you help me out on how you were able to navigate yours?
run opam install --deps-only --with-test .
@sravanpant
I have successfully installed and currently running Ocaml on my local machine.
Glad to be here. I'm done with the first steps and second steps, as it's now running successfully on my Linux PC.
I'm practicing Ocaml exercises at the moment via https://ocaml.org/exercises and looking forward to picking up some issues soon on this repo.
Thanks
I have installed the setup succesfully, finally up and running Ocaml on my WSL2 (ubuntu 20.-04) . Can someone let me know what to do after that, running the exercises or go to good-first issue as i want to apply in "Run OCaml Exercises Everywhere". I'm comparatively new to Ocaml but eager to learn Ocaml.
Good day, Pls I ran into an issue running the second command on my WSL2, can you help me out on how you were able to navigate yours?
Hi @Okay-michael , Can you please clarify the last command you entered and also the error ?
Good day @SaySayo I encountered this error trying to run the second command on my terminal. I use WSL2 on windows. Pls I need help from anyone who has been able to successfully set up and make the required installations.
Ooh, okay, mate, I think the shell script link is dead as it's returning "404".
You can replace bash < <(curl -sL https://ocaml.org/install-platform.sh)
with this instead bash < <(curl -sL https://github.com/tarides/ocaml-platform-installer/releases/latest/download/installer.sh)
Alternatively: You can follow this guide also: https://ocaml.org/docs/ocaml-on-windows#wsl2
This should work for your WSL2.
Reference:
Good day everyone and @saysayo
after cloning the repo, on my ubuntu terminal, i tried to run 'make switch'
here is the error i encountered:
root@7f505a8bdc89:/ocaml.org# make switch opam switch create . 4.14.1 --no-install --repos pin=git+https://github.com/ocaml/opam-repository#8cc107f96e33a4601f7c39346eb19fbbe46486d3 [WARNING] Running as root is not recommended [ERROR] Opam has not been initialised, please run `opam init' make: *** [Makefile:14: create_switch] Error 50 root@7f505a8bdc89:/ocaml.org# opam init [WARNING] Running as root is not recommended No configuration file found, using built-in defaults. Checking for available remotes: rsync and local, git.
[ERROR] Sandboxing is not working on your platform ubuntu: "~/.opam/opam-init/hooks/sandbox.sh build sh -c echo SUCCESS
$TMPDIR/opam-sandbox-check-out && cat $TMPDIR/opam-sandbox-check-out; rm -f $TMPDIR/opam-sandbox-check-out" exited with code 1 "bwrap: Creating new namespace failed: Operation not permitted" Do you want to disable it? Note that this will result in less secure package builds, so please ensure that you have some other isolation mechanisms in place (such as running within a container or virtual machine). [y/N] n
<><> Fetching repository information ><><><><><><><><><><><><><><><><><><><><><> [default] Initialised make switch
Good day everyone and @SaySayo
after cloning the repo, on my ubuntu terminal, i tried to run 'make switch'
here is the error i encountered:
root@7f505a8bdc89:/ocaml.org# make switch opam switch create . 4.14.1 --no-install --repos pin=git+https://github.com/ocaml/opam-repository#8cc107f96e33a4601f7c39346eb19fbbe46486d3 [WARNING] Running as root is not recommended [ERROR] Opam has not been initialised, please run `opam init' make: *** [Makefile:14: create_switch] Error 50 root@7f505a8bdc89:/ocaml.org# opam init [WARNING] Running as root is not recommended No configuration file found, using built-in defaults. Checking for available remotes: rsync and local, git.
- you won't be able to use mercurial repositories unless you install the hg command on your system.
- you won't be able to use darcs repositories unless you install the darcs command on your system.
[ERROR] Sandboxing is not working on your platform ubuntu: "~/.opam/opam-init/hooks/sandbox.sh build sh -c echo SUCCESS >$TMPDIR/opam-sandbox-check-out && cat $TMPDIR/opam-sandbox-check-out; rm -f $TMPDIR/opam-sandbox-check-out" exited with code 1 "bwrap: Creating new namespace failed: Operation not permitted" Do you want to disable it? Note that this will result in less secure package builds, so please ensure that you have some other isolation mechanisms in place (such as running within a container or virtual machine). [y/N] n
<><> Fetching repository information ><><><><><><><><><><><><><><><><><><><><><> [default] Initialised make switch
They say you haven't initialized opam yet. Did you at some point run opam init? I also see mercurial in there, how is that coming in? Did you try to use hg?
run
opam install --deps-only --with-test .
@sravanpant
@SaySayo Thanks for the help. It is now working
Good day everyone and @SaySayo after cloning the repo, on my ubuntu terminal, i tried to run 'make switch' here is the error i encountered: root@7f505a8bdc89:/ocaml.org# make switch opam switch create . 4.14.1 --no-install --repos pin=git+https://github.com/ocaml/opam-repository#8cc107f96e33a4601f7c39346eb19fbbe46486d3 [WARNING] Running as root is not recommended [ERROR] Opam has not been initialised, please run `opam init' make: *** [Makefile:14: create_switch] Error 50 root@7f505a8bdc89:/ocaml.org# opam init [WARNING] Running as root is not recommended No configuration file found, using built-in defaults. Checking for available remotes: rsync and local, git.
- you won't be able to use mercurial repositories unless you install the hg command on your system.
- you won't be able to use darcs repositories unless you install the darcs command on your system.
[ERROR] Sandboxing is not working on your platform ubuntu: "~/.opam/opam-init/hooks/sandbox.sh build sh -c echo SUCCESS >$TMPDIR/opam-sandbox-check-out && cat $TMPDIR/opam-sandbox-check-out; rm -f $TMPDIR/opam-sandbox-check-out" exited with code 1 "bwrap: Creating new namespace failed: Operation not permitted" Do you want to disable it? Note that this will result in less secure package builds, so please ensure that you have some other isolation mechanisms in place (such as running within a container or virtual machine). [y/N] n <><> Fetching repository information ><><><><><><><><><><><><><><><><><><><><><> [default] Initialised make switch
They say you haven't initialized opam yet. Did you at some point run opam init? I also see mercurial in there, how is that coming in? Did you try to use hg?
Nice try bro! You may have missed a step I'm just saying. you can follow this link "https://ocaml.org/docs/installing-ocaml#installing-ocaml" to see if you will get a better result, that was what I followed. Ensure you cd into "ocaml.org" and run this command "git remote add upstream git@github.com:ocaml/ocaml.org.git" before proceeding to "make switch". You may have to be a little patient with it. All the best sir.
So glad, finally got my set up working fine. I've already started engaging with the materials to get fully acquittance with Ocaml!
So glad, finally got my set up working fine. I've already started engaging with the materials to get fully acquittance with Ocaml!
Glad to hear that @Okay-michael :tada:
Hi all,
here's some information about the Outreachy application period. First of all: welcome! 👋
For non-applicants confused by this issue, see this section.
For Applicants
Thanks for choosing to contribute to the OCaml ecosystem! This is the right place to start if you're considering applying to the following project:
Installing OCaml on Your System
Quick Installation
The quickest way to install OCaml currently is using the OCaml Platform Installer.
You'll need to install some dependencies if they're not already installed. This can be done easily using a package manager.
If you're running an Ubuntu/Debian system you can run the following command in your terminal. If you're using Windows, here are the specific instructions, but it is probably easier and quicker to use WSL2 on Windows and then using the Linux/macOS instructions.
sudo apt install bzip2 make gcc bubblewrap rsync patch curl unzip
After your dependencies are installed run the below install script.
bash < <(curl -sL https://ocaml.org/install-platform.sh)
Install the Platform tools.
ocaml-platform
Other Installation Methods
If the OCaml Platform installation method does not suit you then you can take a look at the other installation methods described on ocaml.org: here or there.
Contributions
Before being able to fully contribute to the project, here are simple steps you must follow!
First step: seting up OCaml
If you want to apply to any of the those projects, the first step for you will be to compile OCaml. Please, read through Installing OCaml on Your System. If you're using Windows, here are the specific instructions, but it is probably easier and quicker to use WSL2 on Windows and then using the Linux/macOS instructions.
Now you should be able to go through the basics of OCaml, please follow this tutorial: Your First Day with OCaml.
For more details about the OCaml language you can read this guide about the language.
Try to pick up a few exercises to practice along the way!
Second step: seting up ocaml.org locally
Once OCaml is successfully installed, you also need to install an opam switch that uses a version of OCaml that ocaml.org currently supports, and install the dependencies.
If you are not familiar with Github, a good practice is to fork a repository before working on it. Go on the ocaml.org repository and click on fork.
You can now clone your fork (https://github.com/USERNAME/ocaml.org) to get a local copy of it:
git clone git@github.com:USERNAME/ocaml.org.git
(of course replaceUSERNAME
with your actual github username, without the @).Add the original repository as the "upstream" remote:
cd ocaml.org
git remote add upstream git@github.com:ocaml/ocaml.org.git
Once you have a local repository, let's build:
make switch
To locally run the ocaml.org website, simply run:make start
You should then be able to open the website in your browser at the following URL http://localhost:8080.Once you've achieved that, please let us know here on the issue that you have. And if you have troubles with it, don't hesitate to ask!
Third step: a good first issue
Once you got the website to run locally, you're ready to start contributing. To make a successful contribution:
good-first-issue
andoutreachy
Ask Questions!
You are bound to get stuck somewhere and that's perfectly fine because that means you're moving towards progress!
If you don't know how to move forward with the problem you're stuck with then don't hesitate to ask .
For general questions, you can ask on discord, which you can access via this invitation link. Once you've joined discord, if you have a question about ocaml.org you can ask on the ocaml.org channel. If you have a general question about something else, e.g. how to get OCaml up and running, you can ask on another discord channel, for example on the Outreachy channel.
Happy hacking :)
For Non Applicants
Outreachy is an initiative to give folks from under-represented groups in open-source the opportunity to do a remote internship in an open-source project. So for open-source communities, Outreachy is a great opportunity to work together with folks from lots of different backgrounds and maybe even grow the community and become more diverse! Outreachy provides the infrastructure for the internships and application process, and the open-source communities need to provide projects and mentoring.
A Note on Using ChatGPT and Generative AI for Contributions
We, the mentors for ocaml.org-related projects, have discussed the role of ChatGPT and generative AI during this contribution period and have identified some of the following--non-exhaustive list of--problems in using this technology to contribute.
We don't want these tools to be substitutes for your judgement and understanding. We don't want your responsibility to be deferred to these tools since they are often wrong and hence unreliable. We want to make sure mentors spend their time and efforts helping you improve and learn.
Your judgement and understanding
We don't want contributors to be using generated contributions in situations where we want you to make your judgement. Submitting generated code with little or no understanding as a contribution would be an extreme case of this.
We think if you make a contribution you should be exercising your own judgement and trying your best to solve some problem. Your effort and hard-work are the true essence of any contribution.
Borrowing code has almost always been fine, but even when you do that you are expected to make the judgement to borrow it in the first place. It also is still your responsibility to test that code and abstractly know why that code is there to begin with.
Responsibility
A large part of open-source involves is about taking on responsibility. We think that use of these tools should not take away from that.
Mentor time
With all the contributions, the mentor would be trying to read through this contribution and provide any feedback so that the contributor can learn from this and improve. This takes time and effort on the mentor's part. This would be wasted if they realize half-way that the code was AI-generated.
Mentors want to help you learn and improve. This is difficult or even impossible to do if you don't show them your own work.
Concluding remarks
We only request you to be mindful of all this.
If you happened to use ChatGPT for something like brain-storming ideas for a contribution, that's ok. We ask you in that case to let your mentor know. Giving them the heads up might help them save time and even put you in a better position of trust.