Lab 1 Odd Player Instructions

5-word short stories, GitHub edition

Since you're the ODD player in your pair, you’ll be responsible for getting this whole thing started and adding the 1st, 3rd, 5th, 7th, and 9th contributions to your short story.

Your partner, the EVEN player, will be in charge of the 2nd, 4th...(you get the idea)...and 10th contributions, and finishing the process through making a pull request into the master repository.

Step 1: Visit the burner repository for this lab on Izzy's GitHub, at https://github.com/izzy-shehan/envision-lab-1.

Step 2: Fork the repo to your own github account. You can do this by clicking the “Fork” button in the top right of the page for this repo. This will create an identical copy of the repository on YOUR GitHub account.

Step 3: Add your partner as a collaborator to this new copy of the repo that you’ve forked to your own github. When you’re on the GitHub page for this repo (github.com/your-user-name/five-word-stories, click “Settings” > “Manage Access” > “Invite a Collaborator” and type in your partner’s GitHub username.

Step 4 : Clone your version of this repository (your-username/five-word-stories) into your chosen directory using the command “git clone (link-to-repo-goes-here, no-parentheses). Google how to clone a repo if you can’t remember!

Step 5 : Create a new text file for writing your story with your partner. Hint: say nano <your-filename-goes-here>.txt to will such a file into existence. Follow the terminal’s instructions on how to write out and exit this file. It’d be nice of you to include both partners’ names in the name of the file.

(Note: nano may not work for Windows users. If it says command not found, try notepad <your-filename-goes-here>.txt to open and add the file in notepad. If all else fails, navigate directly to the file through your OS’s file manager and edit it directly in your preferred text editor.)

Step 6 : Write 5 words in your file to get your story off to a great start! When you're done, you can exit nano through hitting Ctrl/Cmd+O to save the file, ENTER to confirm the file name, and then Ctrl/Cmd+X to exit the nano editor.

Step 7: Stage your new file using “git add name-of-your-file.” This will make sure the changes to your new file will get included in your next "snapshot!"

Step 8: Check that your file has been added using the “git status” command. The name of your file should be green, or otherwise indicate that it’s staged for a commit!

Step 9 : Commit your changes with git commit -m “your message here.”. Say something like “Commit #1” in your commit message to help you and your partner keep track as you go.

Step 9 : Push your changes to you and your partner’s repo using the command “git push”. They will be waiting excitedly!

Step 10 : Pull your partner's changes with the "git pull" command once they have pushed the next line in the story to the cloud repo. Once their contribution finally arrives, add your next 5 words, and push your changes back to them.

Step 11 : Repeat. Keep pushing back and forth until you’ve each committed 5 times, and your story is exactly 50 words.

Guidelines for excellence in creative writing

  1. No deleting words!! You've gotta work together, find that sYnErGy

  2. No more and no fewer than 5 words may be added in any commit. There must be exactly 10 total commits, bringing the final story to 50 words.

  3. Anyone can add any punctuation at any time. Punctuation marks do not count as words. Punctuation marks have never counted as words!

  4. Being appropriate is required, being funny is welcome.

Last updated