Welcome to the first steps for becoming an OLE Virtual Intern! We treat these first steps as a vetting process to prove that you can follow simple instructions before you can progress to working on harder projects in bigger teams. Consider them to be the interview for the internship.
If you are selected for the internship after completing the steps, you will be officially invited to join the OLE interns team! We’ll add you to the interns Gitter chatroom and assign you to a specific team to work on developing and improving OLE’s BeLL (Basic e-Learning Library) software. The BeLL is a virtual library that is deployed internationally to individuals in countries that typically do not have access to educational resources.
Once accepted, you and your team will work on an assignment, and we’ll switch up the assignments each week. As part of this internship, you will be working with software and languages including Git, GitHub, Gitter, Markdown, Vagrant, VirtualBox, Command Line/Terminal, Command Line/Terminal Scripts, Vim, CouchDB, Docker, HTML5, Javascript, and Node.js.
NOTE: This is an unpaid but intensive internship that requires 16 hours of work each week. More information about the internship can be found here. If you have further questions, don’t hesitate to ask other members in the Gitter chat!
Social coding is a huge part of any open source and collaborative project, and the Open Learning Exchange is no different. In the following series of steps, you will learn about the Github team workflow, including git, forking, pull requests, and repository issues. You will also be introduced to Markdown’s rich text formatting and OLE’s Basic e-Learning Library (BeLL), the digital library that hosts the learning materials.
Because these steps are simple, we expect high quality work, which may take a longer time. We want to see that you are capable of using or learning how to use these tools (writing good GitHub issues, creating pull requests, navigating the BeLL, etc.). These steps may seem easy, but we want you to impress us with good GitHub etiquette and quality Markdown. The bare minimum would be to just passively follow the steps; you should do further reading about the tools/languages we use so you can further your understanding and relieve confusion if you're unclear about how something works. Treat these steps as learning opportunities! The Github and Markdown skills you practice here are very important in both this internship and a future software development career.
The MD wiki has plenty of resources to help you complete the steps. There is a list of useful links at the end of each step and we created a FAQ page where you can find the answers to some commonly asked questions. This page has even more useful links and video tutorials that will help you become familiar with the tools/languages we use. For anything that is not in the FAQ page, Google and Stack Exchange are your friends :)
We also want you to keep us updated a relatively good amount in the Gitter chat as you complete these steps. Check our Gitter chat page for more information about how to best communicate in Gitter.
A very large part of these steps is finding problems with these steps and this MD wiki, so take note of any issues that you run into or suggestions for improvement while doing these steps. Think of it as improving these steps and this MD wiki for future interns.
There is no official deadline to complete these steps, but most candidates who are approved for the internship program finished the steps within 7-8 days. Good luck!
-
Send us your resume again (along with a short description of yourself and what you would like to be called) to [email protected].
-
Watch Open Learning Exchange and Follow Leonard and Dogi on GitHub. In GitHub we "Watch" organization repositories and "Follow" individuals. When you are on a repository or profile page, look for these buttons in the top right of the screen. Also follow each other to see what others in the group are doing.
- We use Crowdin to translate our user interface in many different languages. If you know another language, go to this Crowdin link to join Crowdin by creating an account. It would be very helpful for you to translate some of the words and familiarize yourself with the software. It would be great to get at least 10% on a language that you speak. If you want to spend additional time, feel free to provide translations to 100%.
Go to this GitHub address to read through the basic instructions on how to create your own digital library (what we call the BeLL, or Basic e-Learning Library). You can either scroll down to see the instructions or you can also find them in the README.md file. Do not make ANY changes to the text or files: simply read and follow the directions for your operating system.
Review these Vagrant instructions to ensure that you have fully completed the previous step. You should be familiar with this since you will need to use it during your internship.
Follow the instructions on the GitHub and Markdown page. Make sure that you've linked to your github.io and your personal .md page on the Gitter chat (<username>.github.io and <username>.github.io/#!pages/profiles/<username>.md).
- Once you complete the Step 3 you will have:
- 1 Pull request made
Follow the instructions under the BeLL-Apps tab.
Follow the directions at Git Repositories to keep your username.github.io and your local repository up to date.
Follow the tutorial under the GitHub Issues tab to create at least one issue. You will be working to improve this MarkDown Wiki so that it is clearer and better for future use. Post a link in Gitter whenever you create an issue or when you comment on someone else's issue. You are encouraged to post as many issues as you can for improving the page as well as for personal practice. If you know how to solve an issue, be sure to provide a detailed account of your research and show how to fix it. Next, fix the issue on your repo and create pull requests, as per the tutorial. Don't forget you can also comment and work on issues that you didn't create. The more you work and commit and push, the more impressive your GitHub profile will become. This is very important to potential employers, thus we encourage you to spend time to increase your numbers to strengthen your profile. Make sure you have created at least one issue, resolved it and have a pull request with the fix merged before proceeding to the next step.
- Once you complete Step 6 you will have:
- 2 pull requests made ( one at step 3 and one at step 6)
- 1 comment added
- 1 issue created
Follow the directions under the Nation BeLL tab.
Create three more issues, add comments to three other issues, and resolve three issues by making the necessary changes in your repo with three separate pull requests. You will follow the same steps as in GitHub Issues, continuing to improve this Markdown Wiki so that it is educational, yet easy to understand for future interns. Just as your learning with this Wiki was made possible by the efforts of previous interns, now we turn to you to continue that tradition, and help future interns take their First Steps. Through this step, you should try to further improve our Markdown Wiki, with better explanations, formatting fixes, and more! Learn by teaching - or editing our teaching tool, in this case!
NOTE: When you are fixing an issue, mention the number of the issue you are fixing in the description of your pull request.
- Once you complete Step 8 you will have:
- 5 pull requests made ( one at step 3, one at step 6 and three at step 8)
- 4 comments made ( one at step 6 and three at step 8)
- 4 issues created ( one at step 6 and three at step 8)
Head over to Open Learning Exchange Repository and make sure you have the following done:
- 5 merged pull requests (1 PR at step-3, 1 PR at step-6 and 3 PR's at step-8).
- 4 comments (1 comment at step-6, 3 comment's at step-8)
- 4 issues (1 issue at step-6, 3 issues at step-8)
If you meet these requirements let us know in the Gitter chat, so we can send the survey to your community. Then, fill out the survey and submit it. Next, Sync your community with the nation (as you did in step 7). Lastly, once you have completed all other steps, add yourself to the virtual intern list found in team.md and create a pull request.
After the pull request, message in the gitter chat or message dogi to let him know you are done so that he can set up a meeting and add you to the team as soon as possible.
Once you have been added to the team, read through the intern orientation document.