These notes cover Professor Saki Bigio's 221A - Monetary Economics I course taught at UCLA during Fall 2022 running from September 22, 2022 to December 9, 2022. Class meets 2:00 pm - 3:15 pm M, W.
Students are meant to make edits to the LyX file and use Git for version control to track the changes they've made and prevent conflict with other students.
- Quick Review of Terms:
- "Git" refers to a program that allows the user to use robust version control on their files. The program is typically used on the "command line" but also has GUI versions available.
- "Github" is a popular website that interface with said program to host code.
- "command-line application" refers to an application that you use in a terminal application. Git for Windows comes bundled with "Git Bash" which is the main terminal application you will use to interface with git. On Mac, you will use the app named "Terminal".
- "Repository", usually referred to as "Repo", refers to a project that is hosted on Github containing all the code under version control.
- Getting Started with Github
- Follow Part 1: Configuring your Github account
- Note: It is advised that you set your username to something professional or close to your name, not your goto username for sketchy forums on the internet.
- Review Part 2: Using Github's tools and processes
- On Download Git select your operating system under Downloads
- Windows: Under Standalone Installer, click "64-bit Git for Windows Setup". Click on the downloaded exe file. The defaults in the installer are generally fine so you can click next several times until it is installed.
- Recommended Mac:
- Install Homebrew. See the website for more details.
- Install Git. Open terminal and type
brew install git
- Install Git credential manager. Open terminal and type
brew tap microsoft/git
followed bybrew install --cask git-credential-manager-core
- Alternative Mac: If you don't want to do the above, visit Downloads for MacOS and just click on the "Binary Installer". After downloading, right click on the file and click install. You will have to do a more complicated set up for connecting with Github later on. Then follow Creating a personal access token. You will need this personal access token when Git asks for your password.
- If you don't want to use the command line, install Github Desktop. Note: this guide will provide no support for this option.
- Set up Git
- In particular focus on "Set your username in Git" and "Set your commit email address in Git"
- Note: The username in "Git" is different from the username in "Github". Please set your "username" in Git as your full name (e.g. the one you would put in Academic papers)
- Note: The email you set here is used to associate the changes you make with your "Github" account. Please read the "Setting your commit email address in Git" carefully.
- Clone this repo
- Navigate to the directory that you will want to store the folder containing these notes (i.e. in Windows Explorer or Finder)
- Right click and select
- Windows: Git Bash Here. This will open up a black terminal program allowing you to access the "Git" command.
- Mac: Open Terminal to this folder (Note: you have to right click the folder itself in Finder, then click New Terminal At Folder. If your version of MacOS is a bit older, the option may be in the Services submenu after right clicking)
- Run
git clone https://github.com/alihaiderismail/Money-and-Banking-Theory-Notes.git
on the command line
- Download the LyX document processor
- How to use Lyx
- You should navigate to Tools->Preferences->Identity and put in your name and email
- Set up Lyx to use Git
- This essentially boils down to using the File->Version Control menu in LyX which makes interacting with Git very easy.
The workflow should look like
- Before editing files:
- Open your terminal application to the folder you cloned the repo to (see 5ii). You should see the word (main) in blue after the folder. If not you are not in the right folder!
- Run
git pull
to get the most up-to-date notes, authenticating if necessary.
- Edit the Lyx file(s)
- Click on File->Version Control->Check in Changes
- If prompted "save your changes"
- You will be prompted with "LyX VC: Log Message". Fill in a short 50 character description of what you did. Then click Ok. 2. Please actually describe the changes. "Updated notes" is not an appropriate commit message.
- In the terminal program, type
git push
to send your changes back to Github- If following the recommended installation: You can type in your Github username and password, and two-factor authentication if you set it up.
- If not: Type in your Github username and personal access token (see 3.3).
Software Carpentry's Intro to Git is a nice tutorial to learn step by step how Git works. Check it out to learn more.
- Visit 22F-ECON-221A-LEC-1 on BruinLearn (only accessible to UCLA students enrolled in the course) for more information.
Lecture Notes Copyright (c) 2022 Saki Bigio
Readme Copyright (c) 2022 Ali Haider Ismail