aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGravatar Andrew Chen <moorheadandrew+github@gmail.com>2011-02-17 15:19:33 -0800
committerGravatar Andrew Chen <moorheadandrew+github@gmail.com>2011-02-17 15:19:33 -0800
commite3d0104e43efbb3724d4156f06310bd915307581 (patch)
treeaf5ec15b06e50aaf21afbf1e2ef65191bdbedb17 /docs
parent90a03b1b91c579a911fbbbbea398124c83726a3f (diff)
Added Getting Started documentation.
Diffstat (limited to 'docs')
-rw-r--r--docs/gettingStarted.pdfbin0 -> 96917 bytes
-rw-r--r--docs/gettingStarted.tex37
2 files changed, 37 insertions, 0 deletions
diff --git a/docs/gettingStarted.pdf b/docs/gettingStarted.pdf
new file mode 100644
index 0000000..f7f2b8e
--- /dev/null
+++ b/docs/gettingStarted.pdf
Binary files differ
diff --git a/docs/gettingStarted.tex b/docs/gettingStarted.tex
new file mode 100644
index 0000000..67357fe
--- /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 \emph{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 \emph{sudo apt-get install python-pygame}.
+ \item \textbf{Setup} logging by running \emph{./setup.sh}.
+ \item \textbf{Run} your LightInstallation code with \emph{python LightInstallation.py}.
+ \end{itemize}
+ \section{Repository Check In}
+ \begin{itemize}
+ \item \textbf{Stage} files to be committed with \emph{./ga}.
+ \item \textbf{Commit} your changes locally with \emph{git commit}.
+ \item \textbf{Push} your changes to your branch with \emph{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 \emph{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 \emph{sudo apt-get install gedit-latex-plugin}.
+ \item \textbf{Publish to PDF} with \emph{pdflatex yourfile.tex}.
+ \item \textbf{View PDF} with \emph{evince yourfile.pdf}.
+ \end{itemize}
+\end{document}