Skip to content
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

add fork-and-update-a-repository.md #345

Open
wants to merge 29 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
e3a8d31
Merge pull request #1 from 1millionwomentotech/master
SeskaBoom Oct 4, 2018
e9ff11a
add images for HOWTO fork and update
SeskaBoom Oct 6, 2018
4c4df60
Delete 1mwtt-forked3.png
SeskaBoom Oct 6, 2018
497ddb6
Delete 1mwtt-forked4.png
SeskaBoom Oct 6, 2018
f88f459
Delete 1mwtt-update2.png
SeskaBoom Oct 6, 2018
7a9ede8
Delete 1mwtt-update3.png
SeskaBoom Oct 6, 2018
8808e78
Delete 1mwtt-update4.png
SeskaBoom Oct 6, 2018
af5571f
replace 5 images for HOWTO
SeskaBoom Oct 6, 2018
929aae8
Add files via upload
SeskaBoom Oct 6, 2018
d189ed1
Delete 1mwtt-forked3.png
SeskaBoom Oct 6, 2018
b79e2bb
Delete 1mwtt-update4.png
SeskaBoom Oct 6, 2018
a83eaf3
Delete 1mwtt-update3.png
SeskaBoom Oct 6, 2018
c023d44
Delete 1mwtt-update2.png
SeskaBoom Oct 6, 2018
a120def
Delete 1mwtt-forked4.png
SeskaBoom Oct 6, 2018
ee826c0
Merge pull request #2 from 1millionwomentotech/master
SeskaBoom Oct 6, 2018
61e0d7c
Add files via upload
SeskaBoom Oct 6, 2018
1773c06
Delete 1mwtt-update1.png
SeskaBoom Oct 6, 2018
987bb73
Add files via upload
SeskaBoom Oct 6, 2018
882a7fb
Create fork-and-update-a-repository.md
SeskaBoom Oct 6, 2018
75a247c
Update fork-and-update-a-repository.md
SeskaBoom Oct 6, 2018
fb4ed60
Delete 1mwtt-update5.jpg
SeskaBoom Oct 6, 2018
2cd9db1
Add files via upload
SeskaBoom Oct 6, 2018
4999fd9
Create install-programs-macos.md
SeskaBoom Oct 6, 2018
7c5eba9
add photos of unity installation
SeskaBoom Oct 7, 2018
95b00b1
update install-programs-macos.md
SeskaBoom Oct 7, 2018
9a224cd
Merge pull request #3 from 1millionwomentotech/master
SeskaBoom Oct 10, 2018
9f50e3f
Add files via upload
SeskaBoom Oct 13, 2018
b93a97f
Update install-programs-macos.md
SeskaBoom Oct 13, 2018
7e3d4e2
Update install-programs-macos.md
SeskaBoom Oct 13, 2018
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 75 additions & 0 deletions howto/fork-and-update-a-repository.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# HOWTO Fork and Update a Repository on Github

Follow these instructions after you have created an account on github.com.

1. Navigate to the 1 Million Women to Tech page on Github: https://github.com/1millionwomentotech

2. Select the toolkitten repository: https://github.com/1millionwomentotech/toolkitten

![1mwtt-fork-toolkitten](images/1mwtt-forked0.png)

3. At the top right of the toolkitten repository you will notice the words 'watch', 'star' and 'fork'.

![1mwtt-fork1](images/1mwtt-forked1.png)

4. Click on 'fork.'

![1mwtt-fork2](images/1mwtt-forked2.png)

5. Your screen will change to an animation with the words 'Forking 1millionwomentotech/toolkitten.'

![1mwtt-fork3](images/1mwtt-forked3.png)

6. Next, you are redirected to your own fork of toolkitten 'YourUsername/tollkitten.'

![1mwtt-fork4](images/1mwtt-forked4.png)

This is your copy of the toolkitten repository! It will only have the exact files that were in the original repository at the moment you created the fork. You will need to keep your fork closely synched to the original, 'upstream repository,' by merging changes daily (actual frequency will depend on the activity level of the upstream repository).

## Updating Your Forked Repository

In order to ensure that your repository is up to date, you must pull and merge changed/new files from the upstream repository (1millionwomentotech/toolkitten).

1. Navigate to your fork or the repository, such as: https://github.com/YourUsername/toolkitten.

2. At the far right, middle of your screen, you will see 'pull request' and 'compare' under the green 'clone or download' button. Click 'compare.'

![1mwtt-update-fork0](images/1mwtt-update0.png)

3. This will take you to 'comparing changes.'

![1mwtt-update-fork1](images/1mwtt-update1.png)

4. Change the base fork to your own repository.

5. Change the head fork to 1millionwomentotech/toolkitten.

![1mwtt-update-fork3](images/1mwtt-update3.png)

6. If your repository is in sync with the upstream you will see 'there isn’t anything to compare.'

![1mwtt-update-fork2](images/1mwtt-update2.png)

7. If there are new files/changes to the upstream repository then you will see a list of commits, file changes, and comments.

![1mwtt-update-fork4](images/1mwtt-update4.png)

8. In order to pull in those changes and merge them with your repository, click 'create pull request.'

![1mwtt-update-fork5](images/1mwtt-update5.png)

9. Add a title and click 'create pull request.'

![1mwtt-update-fork6](images/1mwtt-update6.png)

10. Assuming no conflicts, click 'merge pull request.'

![1mwtt-update-fork7](images/1mwtt-update7.png)

11. Click 'confirm merge.'

![1mwtt-update-fork8](images/1mwtt-update8.png)

12. Congratulations! You have just updated your repository to include all changes from the upstream repository!

![1mwtt-update-fork9](images/1mwtt-update9.png)
Binary file added howto/images/1mwtt-forked0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-forked1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-forked2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-forked3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-forked4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/1mwtt-update9.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo-signup-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo-signup-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo-signup-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_install_7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added howto/images/expo_signup2.png
Binary file added howto/images/install-unity-010.png
Binary file added howto/images/install-unity-011.png
Binary file added howto/images/install-unity-012.png
Binary file added howto/images/install-unity-014.png
Binary file added howto/images/install-unity-1.png
Binary file added howto/images/install-unity-2.png
Binary file added howto/images/install-unity-3.png
Binary file added howto/images/install-unity-4.png
Binary file added howto/images/install-unity-5.png
Binary file added howto/images/install-unity-6.png
Binary file added howto/images/install-unity-7.png
Binary file added howto/images/install-unity-8.png
Binary file added howto/images/install-unity-9.png
178 changes: 178 additions & 0 deletions howto/install-programs-macos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,178 @@
# HOWTO Installation and Signup Guide for MacOS

This document will detail how to install the applications and modules used during the Summer of Code. It will include instructions on how to sign up for websites and services which do not require download/installation. Users of Linux and Windows please refer to the appropriate guide.

### Table of Contents

* [Discord and Discord Desktop](#Install-Discord-Desktop)
* [Python](#Install-Python)
* [Sublime Text 3](#Install-Sublime-Text-3)
* [iTerm2](#Install-iTerm2)
* [PIP](#Install-pip)
* [NLTK](#Install-NLTK)
* [Jupyter Notebook via Anaconda](#Install-Jupyter-Notebook-via-Anaconda)
* [Jupyter Notebook without Anaconda](#Install-Jupyter-Notebook-without-Anaconda )
* [NodeJs](#Install-Nodejs)
* [NPM](#Install-NPM)
* [JavaScript Standard Style](#Install-JavaScript-Standard-Style)
* [InvisionApp](#Install-InvisionApp)
* [Ganache](#Install-Ganache)
* [Overflow](#Install-Overflow)
* [Unity3D](#Install-Unity3D)
* [Developer Mode on Android Phone](#Enable-Developer-Mode-on-Android-Phone)
* [JDK](#Install-JDK)
* [Android Studio - alternative to using an android phone](#Install-Android-Studio)
* [Tinkercad](#Register-for-Tinkercad)
* [Blender](#Install-Blender)
* [Android Studio](#Install-Android-Studio)
* [Sketchup](#Install-Sketchup)
* [Gimp](#Install-Gimp)
* [Gitkracken](#Install-Gitkracken)
* [Sourcetree](#Install-Sourcetree)
* [React.js](#Install-React.js)
* [](#Install)
* [](#Install)



## Install Python

## Install Sublime Text 3

## Install iTerm2

## Install pip

## Install NLTK

## Install Jupyter Notebook via Anaconda

## Install Jupyter Notebook without Anaconda (for those who already have Python and prefer...)

## Install Nodejs

## Install NPM

## Install JavaScript Standard Style

## Signup for Invisionapp

## Install Ganache

## Install Overflow

## Install Unity3D
Unity3D is a cross-platform game engine used for games and interactive simulations and visualizations.

1. Navigate to the Unity downloads page.
https://unity3d.com/unity/qa/lts-releases

![unity1](images/install-unity-1.png)

2. Select the newest LTS release. Under 'Unity Editor Download Assistant' click Download(Mac).

![unity2](images/install-unity-2.png)

3. On the lower toolbar or in your downloads folder, click to open the Unity installer.

![unity3](images/install-unity-3.png)

4. Click on the Unity Download Assistant.

![unity4](images/install-unity-4.png)

5. A message will appear warning that Unity is dowloaded from the internet, click 'open.'

![unity5](images/install-unity-5.png)

6. Go through the process process of approvals and agreements with the assistant.

![unity6](images/install-unity-6.png)
![unity7](images/install-unity-7.png)

7. Choose which components to install (the default is all).

![unity8](images/install-unity-8.png)

8. MacOs requires your password for installation.

![unity9](images/install-unity-9.png)

9. Select where to install.

![unity010](images/install-unity-010.png)

10. The download and installation process will run for several minutes.

![unity011](images/install-unity-011.png)

11. Process complete! Close the assistant, Unity will open automatically.

![unity012](images/install-unity-012.png)

12. Move the Unity Download Assistant to the trash.

![unity014](images/install-unity-014.png)

## Enable Developer Mode on Android Phone

## Install JDK

## Install Android Studio (if you do not have access to an android phone)

## Register for Tinkercad

## Install Blender

## Install Android Studio

## Install Sketchup

## Install Gimp

## Install Gitkracken

## Install Sourcetree

## Install React.js
There are two ways to work with React.js: you may work from your web browser or install to your computer.

Option 1:
To work with react in your browser, go to https://snack.expo.io/. To save your progress, select save, which will give you a permanent link.

![expo_1](images/expo-signup-1.png)

2. You may also crreate an account to easily track your project.

![expo_2](images/expo-signup-2.png)

3. You will recieve an email asking you to confirm your address.

![expo_3](images/expo-signup-3.png)

Option 2: Create React App
This app will allow you to create an app with minimal installation, however the project size is limited to a one page app.

This installation requires you to have Node on your computer. If you did not install it during the Javascript course, please go back to the week 7 Node install.

1. In your terminal, change your directory to the location where you want your react project.

2. In your terminal, type: **npx create-react-app my-app**.

3. Change your directory to the location where you want your react project **cd .../my-app**.

4. Type: **npm start**.

Option 3: Expo CLI
This app is a command line environment will allow you to build projects.

This installation requires you to have Node on your computer. If you did not install it during the Javascript course, please go back to the week 7 Node install.

1. In your terminal, change your directory to the location where you want your react project: **cd .../my-app**..

2. Type **npm install -g expo-cli -- global**, this will install the Expo CLI command line utility.

3. Next, create a new project, type **expo init Project_Name**.


4. In your terminal change your directory to the new folder: **cd Project_Name**. Then **expo start**.