waystilos/uxebootcamp-b12.styleguide

UXE - Style Guide

To me, a style guide is a living document of code, which details all the various elements and coded modules of your site or application. Beyond its use in consolidating the front-end code, it also documents the visual language, such as header styles and color palettes, used to create the site. This way, it’s a one-stop place for the entire team—from product owners and producers to designers and developers—to reference when discussing site changes and iterations. Several companies have even put their guides online; Starbucks is the most well known of the bunch, but others exist.

ref

Submitting assignments

Submitting assignments for this course will require leveraging some of the more advanced features of Github. These features will not only improve your knowledge of Git and Github, but also provide practice exercises for working on a distributed project with a large team.

How to submit an assignment

In order to submit assignments, please use the following steps

1. Fork this repo so that you have a working version
2. Clone the forked repo to your local computer
3. Create a folder named with your name and the class designator, example dale-sande-b12
4. Once completed with your assignment, commit code to the master branch and push to Github git push origin master
5. From your fork of the project, initiate a pull request to the parent repo

Assignment review

When a pull request is initiated, I will be notified of the update and comment on the submitted assignment via Github tools.

Keeping your local repo up to date

Your local repo will be an independent version of the original repo from the moment you fork the repo. In order to keep your local repo up to date with the original repo, you need to do what is called an upstream pull.

To manage an upstream pull, I suggest updating your .bash_profile and your .gitconfig file with easy to remember aliases.

.bash_profile

In your .bash_profile add the following alias

alias upstream="git remote add upstream \$@"

From the command line you simply need to refer to the alias and add the path to the upstream repo as shown in the following example.

$ upstream https://github.com/blackfalcon/unicorn-class-css-section.git

Once the upstream repo is configured for your local repo, this never needs to be reset again, unless you delete your local repo.

.gitconfig

In your .gitconfig add the following alias

pu = !"git fetch origin -v; git fetch upstream -v; git merge upstream/master"

From the command line, within the project repo, enter the following command to pull latest code from the upstream master.

git pu