MBoutique

Assignment 1

We will be building out the first page of the MBoutique website

Code Setup Details

#####1. Open PHPStorm

You should be opening phpStorm to your lfz directory for all projects

Expand the mBoutique folder to view the project files

Make sure to add all project related files to the proper directory

  • For this project it should be: lfz/mboutique

#####2. Navigate to mBoutique in the terminal

Insert this command in the terminal tab

cd mboutique & press enter

  • this changes the directory to the mboutique folder
  • If you get an error with the above command its probably because you are already within the correct directory

#####3. Create a feature grouping (Create feature branch)

Insert & execute these command in the terminal tab individually

git checkout master & press enter

  • The command above switches to the default branch

git checkout assignment_1

  • Creating this feature groupings allow users to modify code without causing issues with the current functioning code.
  • Any modifications to these files after branching can be undone
  • "assignment_1" is the branch name.

Coding Instructions

Feature Set 1

  • Create the HTML and CSS necessary to reproduce the MBoutique home/welcome page - Use the index.html file for your HTML - Use the style.css file for your CSS
  • Use the design images for reference (Found in the assets folder)

Screenshot Example

MBoutique Home Page Screenshot

Design Doc

MBoutique Home Page Design Doc

Suggestions

  • Break the page down into sections and build one section at a time. For example: - Header section - Body/Main content section - Footer section
  • Keep in mind that there are multiple pages
    • Notice the sections that are the same on all pages like the header and footer
    • Design your HTML so that it will be easy to reuse the header and footer sections on all the pages
  • Don't panic
    • If you get stuck or have any issues use google or the LearningFuze forum
  • If you are familiar with them, make use of the chrome developer tools to prototype out your changes.
  • Test each CSS change as you implement it. It can be difficult to ascertain "what went wrong" if you do many lines of code and then test it.
  • Pay attention to the gross details first, and then make a second pass for fine details.

After Coding Details

1. Save files to Git - Add all modified & created files

Run below command in terminal tab

git add .

Saving files to Git registers the changed files in Git, allowing them to be grouped together by a message (commit)

2. Package (group) all saved git files with a commit message

Run below command in terminal tab

git commit -m "mboutique Assignment_1 - Eric Johnson"

  • Eric Johnson should be replaced with your First & Last name
  • Grouping files with a message allows those changes to be seen by others as a specific version of the code
3. Allow others to see your changes by uploading them to the Github website

Run below command in terminal tab

git push origin assignment_1

  • When running the code above, the Git application will send all commits (groupings of saved files) to the remote location (github.com/[your-user-name]/mboutique indicated by origin), specifically to the feature branch/group assignment_1
4. See if your feature fits with what everyone else was working on (Pull Request)

####Step 4.1 Open your mboutique Repo in the browser

  • The link Should follow this format github.com / [your user name] / mboutique

####Step 4.2 Click Pull request tab to open the pull request list

####Step 4.3 Click "New Pull request" button

####Step 4.4 Comparing Changes

During this step there are a hand full of highlighted things that need to be taken into consideration.

###The image below is just an example.

###Make sure to change the options according to the written directions below

  1. base fork: Learning-Fuze/mboutique
  2. base: C#_userName
  3. Here you will select the option that matches your username
  4. If you can not locate an option that has your username, contact an instructor
  5. head fork: [your_user_name]/mboutique
  6. Here you will select the option that matches your username / mboutique
  7. If you can not locate an option that has your username / mboutique, contact an instructor
  8. compare: assignment_1
  9. Here you will locate the branch name (or feature name) you created at the beginning of the assignment
  10. Github.com will let you know if the code can be merged automatically (without needing a manual merge)
  11. If the text says something other than "able to merge". Contact an instructor
  12. Sometimes a manual merge is necessary, it just has a couple more steps when completing the request (done by instructors at start)
  13. Once we have verified #1 - #4 and noted #5, we click the "Create Pull request" button (#5 in the image above)

####Step 4.4 Add details into the pull request

  1. Give the pull request a title, by default its the name of the last commit (package) message that was saved
  2. If you set the commit message above you should get get mboutique Assignment_1 - [you name first & last name] already pre populated in the Title field
  3. Don't assign a user. (An Instructor will select who this gets assigned too)
  4. Further into the cohort we will have students learn to review pull requests
  5. Click on "Create pull Request"


5. Collaborate on feedback

Within the Github.com UI another developer or in this case an instructor will review the Pull Request you made - Is your feature working. Collaboration happens through github UI & the notifications are sent through email when comments are added to pull requests

  • Students should make modifications to there code based on the instructors feedback
  • Instructors will be giving an initial assessment based on the pull request. Any additional collaboration after the instructor has been feedback will be on a requested basis only.
6. Pull Request Closed
  • In the LearningFuze workflow the pull requests are closed to indicate assessment has been given to the student and recorded.