diff --git a/README.md b/README.md index 5182f7b..cadb8a5 100644 --- a/README.md +++ b/README.md @@ -1 +1,109 @@ -# bootcamp-programming-22 \ No newline at end of file +# bootcamp-programming-22 + +## Don't panic + +If something’s not working, that’s perfectly normal. You’ll get used to it, that sometimes things don’t go as you planned, even when you are following precise instructions. + +## Git + +### What is git? + +Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. [More about git.](https://www.freecodecamp.org/news/what-is-git-learn-git-version-control/) + +### Do you have git installed on your computer? + +On **Windows**, open the *Command Line* or *PowerShell*. + +On **Mac** or **Linux** open *Terminal*. + +```Terminal +git --version +``` + +If you get a result similar to the following you are good to go: + +```Terminal +git version 2.35.3 +``` + +### What to do when you don't have git installed? + +Well, you'll need to install it. + +There’s a guide on the official Git website, that you can follow. [Click here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) + +If you are on **Windows** [here](https://shalmonanandas.github.io/tutorials/2022/04/05/Git-+-Github-for-beginners.html) is a detailed guide, which includes the setup of Windows Terminal as well. + +For setting up a GitHub repository, you can check [this](https://shalmonanandas.github.io/tutorials/2022/04/05/Git-+-Github-for-beginners.html) guide from the 5th chapter. + +#### Additional resources to learn about Git + +- [GitHub - How to create a repo](https://docs.github.com/en/get-started/quickstart/create-a-repo) +- [FreeCodeCamp - Beginner's Guide to Git](https://www.freecodecamp.org/news/a-beginners-guide-to-git-how-to-create-your-first-github-project-c3ff53f56861/) +- [The difference between Git and GitHub](https://www.geeksforgeeks.org/difference-between-git-and-github/) + +## Python + +### What is Python? + +Python is a popular general-purpose programming language that can be used for a wide variety of applications. To learn more [click here](https://opensource.com/resources/python). + +### Do you have Python installed on your computer? + +On **Windows**, open the *Command Line* or *PowerShell*. +On **Mac** or **Linux** open *Terminal*. + +```Terminal +python3 --version +``` + +If you have 3.6 or higher, you are good to go + +### What should you do if you have lower than the required version, or you don’t have Python installed at all? + +- [General instructions](https://realpython.com/installing-python/) +- [Linux specific instructions](https://www.geeksforgeeks.org/how-to-install-python-on-linux/) +- [Windows specific instructions](https://www.python.org/downloads/) +- [Windows specific instructions - 2](https://phoenixnap.com/kb/how-to-install-python-3-windows) +- [Mac specific instructions](https://www.python.org/downloads/) + +## Do you have your preferred text editor / IDE installed? + +If you don’t have a preferred text editor / IDE installed, we recommend you use **VS Code**. + +### Installing and setting up VS Code + +[Download and install](https://code.visualstudio.com/) + +VS Code basics: + +- [Academind - VS Code Tutorial for Beginners](https://www.youtube.com/watch?v=VqCgcpAypFQ) +- [VS Code Official Website](https://code.visualstudio.com/docs/introvideos/basics) + +Recommended Extensions: + +- [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) +- [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) +- Andrew’s recommended extensions + +## Task #1 + +1. Create a github repository called: `hive_python_hello` +2. Follow the below file structure. +3. Write a program, which includes a function called `hello` that will `print` "Hello World!" +4. Push the file and the folder to the repository. +5. Share the repository with the following user: `something@hive.com` + +```folder +. +|hello_world +|--hello_worly.py +``` + +## Task #2 + +1. Clone the following GitHub repository: [Bootcamp-22](https://github.com/electrichive/bootcamp-programming-22) +2. Create a new branch +3. Add your GitHub username to the end of the list in `users.md` +4. Push your changes to your branch +5. Create a Pull Request