New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Outreachy Summer 2024 #2141
Comments
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! |
Thank you @SaySayo for this guide. I'm currently setting up my development environment and look forward to asking questions and contributing successfully too. |
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 |
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; What I'm I missing? |
Hello @SaySayo |
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 Did you resolved the issue? why this link |
No I haven't yet @SobiaAman . |
Hello @SaySayo @Aquilaafuadajo i'm stuck at
Secondly i tried to access the shell script but it is not available at |
That is exactly the same thing on my end @SobiaAman |
Hi @SobiaAman @jahielkomu |
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 |
W
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 |
Thank you for this guide, I have successfully installed and I'm running it 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? |
Hello @SaySayo , |
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 |
Hello @SaySayo Error 1:
and hence I am not able to load the website using the command Error 2:
Pls help me with this issue |
run |
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 |
Hi @Okay-michael , Can you please clarify the last command you entered and also the error ? |
Ooh, okay, mate, I think the shell script link is dead as it's returning "404". You can replace 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
[ERROR] Sandboxing is not working on your platform ubuntu: <><> Fetching repository information ><><><><><><><><><><><><><><><><><><><><><> |
They say you haven't initialized opam yet. |
@SaySayo Thanks for the help. It is now working |
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. |
Glad to hear that @Okay-michael 🎉 |
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.
The text was updated successfully, but these errors were encountered: