created first draft of directions

Author: kvnyng

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,15 +2,9 @@
 
 - [ ] I am 19 or under.
 - [ ] I am a current high school student (or younger).
-- [ ] I am a member of the Hack Club Slack (Join at <https://hackclub.com/slack>).
+- [ ] I am a member of the Hack Club Slack (Join [here](https://hackclub.com/slack>)).
 - [ ] I have followed [DIRECTIONS.md](https://github.com/hackclub/OnBoard/directions.md)
-  - [ ] Uploaded design files to my fork of `OnBoard-template`
-- [ ] My board passes JLCPCB inspection
-- [ ] Filled out my contact card (below)
-
-**Contact Card:**
-```yml
-Name: 
-Slack Handle: 
-Project Name: 
-```
+  - [ ] Created a folder under `onboard/projects`
+  - [ ] Filled out `TEMPLATE.md`
+  - [ ] Uploaded Gerber and design files
+  - [ ] Uploaded screen shot of PCB passing JLCPCB inspection

.gitmodules

@@ -2,28 +2,55 @@
 Interested in submitting to OnBoard? You're in the right place!
 
 ## 1. Fork!
-- [ ] Fork of this repo [`onboard`](https://github.com/hackclub/OnBoard/)! This is the where you'll add your project and eventually PR from.
-- [ ] Fork [`Onboard-template`](https://github.com/hackclub/OnBoard-template/) and give it a name! This will be your project repo where you store your design files, Gerbers, and budget.
+Fork the [`onboard`](https://github.com/hackclub/OnBoard/) repo! This is the where you'll add your project files and eventually PR from!
+
+![Fork the OnBoard repo](docs/images/directions/OnBoard-Fork.png)
 
 ## 2. Design a Board!
 It's design time! Head over to an eCAD software of your choice (EasyEDA, KiCAD, Eagle) and start designing!
 
 Never designed before? No problem! We have design resources for EasyEDA, a free online eCAD program. Check them out here.
 
 ## 3. Upload to JLCPCB and Check
-- [ ] Upload your Gerber files to JLCPCB and make sure they pass inspection. 
+Upload your Gerber files to JLCPCB and make sure they pass inspection. This is done by going to check out and selecting the review before paying option.
 
-This is **VITAL** since your project will only be approved if it passes inspection. Take a screen shot. You'll include this in your PR later.
+This is **VITAL** since your project will only be approved if it passes inspection. **Take a screen shot**. You'll include this in your PR later.
 
 ## 4. Add Your Design to Your Project Repo
-- [ ] Add your design files (schematics, PCB, and Gerbers) to the project repo you made earlier!
+From your fork of `OnBoard`, create a folder with your project name under `OnBoard/projects`. To do this, go to the projects folder and click `Create new file`.
+
+![Projects folder](/docs/images/directions/projects.png)
+
+![Create new file](/docs/images/directions/add-file.png)
+
+Then in the box labeled `name your file...`, type in `GITHUB_USERNAME/README.md`. This creates a README file under a folder called your Github username.
+
+![Creating a folder](/docs/images/directions//creating-a-folder.png)
+
+After this, copy and paste the contents of [`TEMPLATE.md`](./projects/!Template/TEMPLATE.md) into the text editor and fill it out!
+
+![Paste in TEMPLATE.md](docs/images/directions/paste-in-template.png)
+
+Press the big green `Commit changes` button to save!
+
+Once this is done, go under your folder and begin uploading your Gerber, design files, and screen shot of JLCPCB approval. In all, you should have the follow files under your project folder:
+- [ ] `Gerbers.zip`: This should be the file that you send off to JLCPCB.
+- [ ] `JLCPCB.png`: A screen shot of JLCPCB approving your board
+- [ ] Design files (`design.json`, `design.sch`, `design.brd`, etc). Whatever format your designer outputs to should be included.
+- [ ] `README.md`: A filled out [`TEMPLATE.md`](./TEMPLATE.md), renamed to `README.md`
+
+If you have all the above, you're done with this step!
 
-## 5. Add Your Project to OnBoard
+## 6. Create a PR!
+Once you've uploaded your files, you can merge them to the main repo through a pull request! Under the contribute tab of your forked repo, click the big green `Open pull request`.
 
+![Open a PR](docs/images/directions/open-pr.png)
 
-## 6. Create A PR
+That will bring you to the main repo, where you'll initiate a pull request. Follow the checklist, we'll then review your PR and you'll be off to the races!
 
+![Submission checklist](docs/images/directions/submission-checklist.png)
 
-## 7. Celebrate!
-Post photos of your board in `#onboard`! Can't wait to see what you make!
+## 7. Ship it!
+Post photos of your board in `#onboard`! We can't wait to see what you make!
 
+![John sharing PCB](docs/images/directions/john-sharing-pcb.png)

DIRECTIONS.md

@@ -10,4 +10,4 @@ Never designed a PCB before? You're in the right place! The OnBoard community ha
 
 ## PCB Tutorials
 
-## Reputable Manufactures
+FILL ME IN!

docs/design_resources.md

@@ -0,0 +1 @@
+Remember to upload your Gerber files!

docs/images/directions/OnBoard-Fork.png

@@ -0,0 +1,10 @@
+# Template
+Hey there! This is a template for what you'll need to upload to GitHub to receive a grant for OnBoard!
+
+Everything should reside in `onboard/projects/YOUR-PROJECT-NAME`. 
+
+Items that must be included:
+- [ ] `Gerbers.zip`: This should be the file that you send off to JLCPCB.
+- [ ] `JLCPCB.png`: A screen shot of JLCPCB approving your board
+- [ ] Design files (`design.json`, `design.sch`, `design.brd`, etc). Whatever format your designer outputs to should be included.
+- [ ] `README.md`: A filled out [`TEMPLATE.md`](./TEMPLATE.md), renamed to `README.md`

docs/images/directions/add-file.png

@@ -0,0 +1,16 @@
+---
+name: "NAME"
+slack_handle: "SLACK HANDLE"
+github_handle: "GITHUB HANDLE"
+project: "PROJECT NAME"
+---
+
+# PROJECT NAME
+## Summary
+##### Describe your board in 2-3 sentences. What are you making? What will it do?
+
+## Plan
+##### How much is it going to cost? What's your timeline?
+
+## Design
+##### Tell us a little bit about your design process. What were some challenges? What helped? ***Totally optional**

docs/images/directions/creating-a-folder.png

@@ -0,0 +1 @@
+.json containing exports from EasyEDA.

docs/images/directions/john-sharing-pcb.png

@@ -0,0 +1,2 @@
+Here would be where I put my schematic file. 
+If you're using EasyEDA, you'll have have .json file.

docs/images/directions/open-pr.png

@@ -0,0 +1,24 @@
+---
+name: "Kevin Yang"
+slack-handle: "keviny"
+github-handle: "bykevinyang"
+project: "Orpheus Leap"
+---
+
+# Orpheus Leap
+
+## Summary
+##### Describe your board in 2-3 sentences. What are you making? What will it do?
+The Leap was a board I designed during to congratulate everyone in Summer of Making! It's a Arduino Leonardo in the shape of our lord and savior, Orpheus! We made 500 of them and shipped them to makers around the world!
+
+## Plan
+##### How much is it going to cost? What's your timeline?
+The Leap costed ~$6 per board. I made it during the Summer of 2020 🏖️.
+
+## Design
+##### Tell us a little bit about your design philosophy. What were some challenges? What helped? ***Totally optional**
+I wanted the Leap to be a beautiful sendoff for Summer of Making. It's components follow the natural contours of Orpheus. She's also fully functional, able ot act as a USB device (the pros of using an Arduino Leonardo).
+
+The board shape was defined in Adobe Illustrator, cleaned up in Fusion 360, and routed in Eagle. If you have questions about making wacky shaped boards, hit me up on slack `@Kevin Yang`.
+
+#### This folder is an example for OnBoard