aboutsummaryrefslogtreecommitdiff
path: root/docs/gettingStarted.tex
diff options
context:
space:
mode:
Diffstat (limited to 'docs/gettingStarted.tex')
-rw-r--r--docs/gettingStarted.tex37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/gettingStarted.tex b/docs/gettingStarted.tex
new file mode 100644
index 0000000..4d88ace
--- /dev/null
+++ b/docs/gettingStarted.tex
@@ -0,0 +1,37 @@
+\documentclass{article}
+\usepackage{fullpage}
+\usepackage{hyperref}
+\begin{document}
+ \title{150 Smoots Getting Started on Linux}
+ \author{Andrew Chen}
+ \date{\today}
+ \maketitle
+ \section{Repository Access}
+ \begin{itemize}
+ \item \textbf{Install} Git packages with \texttt{sudo apt-get install git-core git-gui git-doc}. Set up your basic git settings \href{http://help.github.com/git-email-settings/}{like so}.
+ \item \textbf{Sign up} for a GitHub account (\href{https://github.com/signup/free}{here}) then ask Russell to add your account as a collaborator to the rcoh/SmootLight code repository.
+ \item \textbf{Connect} to the SmootLight GitHub code repository. Generate SSH keys and upload the public one to GitHub by following the instructions \href{http://help.github.com/linux-key-setup/}{here}.
+ \item \textbf{Clone and branch} the code repository; use \href{http://help.github.com/git-cheat-sheets/}{this cheatsheet} for help as necessary.
+ \end{itemize}
+ \section{Testing on Pygame}
+ \begin{itemize}
+ \item \textbf{Install} Pygame with \texttt{sudo apt-get install python-pygame}.
+ \item \textbf{Setup} logging by running \texttt{./setup.sh}.
+ \item \textbf{Run} your LightInstallation code with \texttt{python LightInstallation.py}.
+ \end{itemize}
+ \section{Repository Check In}
+ \begin{itemize}
+ \item \textbf{Stage} files to be committed with \texttt{./ga}.
+ \item \textbf{Commit} your changes locally with \texttt{git commit}.
+ \item \textbf{Push} your changes to your branch with \texttt{git push origin yourbranchname}.
+ \item \textbf{Request a pull} to the source repository by following instructions \href{http://help.github.com/pull-requests/}{here}.
+ \item \textbf{Learn more} about working with remote repositories \href{http://help.github.com/remotes/}{here}.
+ \end{itemize}
+ \section{Latex Documentation}
+ \begin{itemize}
+ \item \textbf{Install} Latex packages to be consistent with current documentation style. I had to run \texttt{sudo apt-get install texlive-fonts-recommended texlive-latex-extra} to successfully convert Russell's .tex to pdf.
+ \item \textbf{Edit} the .tex files with any text editor. I use vim for quick edits and gedit with the Latex plugin for autocompletion and quick previews. Get the Latex plugin with \texttt{sudo apt-get install gedit-latex-plugin}.
+ \item \textbf{Publish to PDF} with \texttt{pdflatex yourfile.tex}.
+ \item \textbf{View PDF} with \texttt{evince yourfile.pdf}.
+ \end{itemize}
+\end{document}