- Lorem, ipsum dolor sit amet consectetur adipisicing elit. Nulla nisi
- excepturi quidem, eum rem doloribus quam aspernatur hic enim eligendi
- commodi minima ullam necessitatibus, cumque blanditiis, nihil magni
- amet consectetur?
-
This was exactly as it says: a t-shirt order form, in HTML and CSS. This text is copy-pasted.
+
+ In this project I learned a whole bunch of foundational principles
+ for front end: I learned how to structure data formally with
+ modern native form inputs, and how to validate that data client-side with HTML5
+ attributes. The brief was fairly open - the design is all mine,
+ but the Acceptance Criteria was strict: I had to deliver a perfect
+ score in Lighthouse, and meet some other validation constraints.
+
+
+ I spent a lot of time testing my code with Devtools and thinking
+ carefully about the semantics of the copy pasted DOM. I also explored the
+ Coverage evaluator and used it to improve my CSS: only delivering
+ precisely what my design needed and no excess code.
+
+
+
+
Contact me
From 2b589e7639154274eb4a0eb28807b3a57b316ca1 Mon Sep 17 00:00:00 2001
From: Sally McGrath
Date: Mon, 27 Mar 2023 10:35:15 +0100
Subject: [PATCH 02/33] annotated styles for example page
- added some interesting links to explain some concepts used here
- an example card layout using grid
- my standard rules for images
---
style.css | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++---
1 file changed, 98 insertions(+), 4 deletions(-)
diff --git a/style.css b/style.css
index c911f90c..ec5097cb 100644
--- a/style.css
+++ b/style.css
@@ -1,4 +1,7 @@
-/* Design tokens */
+/* Design tokens.
+With tokens, stick to communicating the PURPOSE not the VALUE.
+Code should explain, not mystify, your design.
+*/
:root {
--paper: hsla(251, 28%, 88%, 0.99);
--ink: hsla(244, 16%, 17%, 0.95);
@@ -6,8 +9,22 @@
--font: "Raleway", system-ui, sans-serif;
--gap: 20px;
--container: clamp(280px, calc(100vw - calc(var(--gap) * 2)), 1180px);
+ /* https://web.dev/accessible-tap-targets/ */
+ --tap-target: 48px;
+ --box: clamp(280px, 50vw + 2px, 530px);
}
-/* General Styles */
+
+/* Hey look, dark mode is
+so easy with design tokens done this way
+*/
+@media (prefers-color-scheme: dark) {
+ :root {
+ --ink: hsla(252, 38%, 92%, 0.99);
+ --paper: hsla(244, 16%, 17%, 1);
+ }
+}
+
+/* General styles */
html,
body {
scroll-behavior: smooth;
@@ -34,7 +51,12 @@ a:focus {
color: var(--brand);
border-color: currentColor;
}
-/* Site header and navigation */
+p a:any-link {
+ border-color: var(--brand);
+}
+/* Site header and navigation
+https://elad.medium.com/css-position-sticky-how-it-really-works-54cd01dc2d46
+*/
body > header {
background: var(--paper);
display: flex;
@@ -50,8 +72,80 @@ nav ul {
gap: var(--gap);
}
-/* Text readability */
+/* Text readability
+https://baymard.com/blog/line-length-readability
+*/
section p {
line-height: 1.5;
max-width: 55ch;
}
+/* targeted resets
+We're resetting elements with a class - ANY class
+- on the grounds that if you added a class,
+you added your own styles
+*/
+h3[class] {
+ margin: 0 auto 0 0;
+}
+ul[class],
+li[class] {
+ margin: 0;
+ padding: 0;
+}
+
+/* Basic image rules
+Don't size images in css, size their containers
+Just make images take up the entire space you give them
+in every context
+*/
+svg {
+ height: 100%;
+ width: auto;
+ min-width: var(--tap-target);
+}
+
+img {
+ width: 100%;
+ height: 100%;
+ max-width: 100%;
+ object-fit: cover;
+}
+
+picture {
+ height: auto;
+ overflow: hidden;
+}
+/*
+I would start breaking this up into component files now btw!
+*/
+.showcase {
+ display: flex;
+ flex-flow: row wrap;
+ gap: var(--gap);
+}
+/*
+Here's an example of a grid layout. Notice there's no margin, padding, or sizes given on elements
+All the spacing and sizing is set on the template, and the elements
+are just slotted in.
+The little dots are how we precisely place and size white-space
+https://www.interaction-design.org/literature/article/the-power-of-white-space
+*/
+
+.project {
+ display: grid;
+ grid-template:
+ "picture picture picture" var(--box)
+ "....... ....... ......." calc(var(--gap) / 2)
+ "....... heading ......." min-content
+ "....... blurb ......." auto /
+ var(--gap) var(--box) var(--gap);
+}
+.project__picture {
+ grid-area: picture;
+}
+.project__heading {
+ grid-area: heading;
+}
+.project__blurb {
+ grid-area: blurb;
+}
From 23da459d509de0aea16b319ee2e274cea739365d Mon Sep 17 00:00:00 2001
From: Sally McGrath
Date: Mon, 27 Mar 2023 10:35:49 +0100
Subject: [PATCH 03/33] A new challenge for module 1
New readme
---
README.md | 46 +++++++++++++++++++++++++++++++++++++---------
1 file changed, 37 insertions(+), 9 deletions(-)
diff --git a/README.md b/README.md
index 98549832..bbc02378 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,46 @@
# Portfolio
-Your starting portfolio, to iterate on.
+Module 1 iteration of your portfolio. We've got a lot of new concepts here so you might want to work through this in your study group, or bring to class for help.
## Learning Objectives
-- Customise the starting portfolio with your professional details
-- Iterate on your portfolio every module
-- Review your colleague's portfolio
+- [ ] Branch from a branch in Git
+- [ ] PR from a branch to a branch in GitHub
+- [ ] Create a personal case study for a project
## Requirements
-At Code Your Future, we expect everyone to graduate with a unique professional portfolio. Begin building this portfolio as soon as you begin our Software Development Course. At first, your portfolio will be a simple HTML/CSS page deployed to Github Pages or Netlify. This is your MVP.
+We are using a different type of pull request workflow from your main coursework. We're doing this because we need lots of practice with Git to be ready to contribute to shared repos like professional developers. In previous years, we only opened PRs to main all the way through the course, and then in Final Projects it was really hard to learn branching and merging. So let's practice a different workflow now.
-Every module, you will _iterate_ on your portfolio, adding a new project and improving your design and presentation. By the time you apply to Final Projects, your portfolio will help you show you are ready to be accepted on to a Final Projects team.
+## Git Ready: Putting our code in the right place
+
+The instructions here are given for the command line, but you could just as easily do this in GitHub Desktop or GitKraken.
+
+1. Switch into the branch called `git checkout Module-HTML-CSS` to access this Readme
+1. From `Module-HTML-CSS`, create a new branch `git checkout -b your-name-portfolio`
+1. Make a new directory `mkdir your-name-portfolio`
+1. Move your starter files into this directory `mv index.html style.css your-name-portfolio`
+1. Change into the new directory `cd your-name-portfolio`
+1. Check you are in the right branch `git branch --show-current`
+
+## Git Set: Making changes
+
+1. Open the project in your code editor
+1. Make your changes
+1. Check your changes with `git status`
+1. Add your files to the staging area `git add index.html style.css` . _Remember, don't `git add .` or you could add files you don't mean to._
+1. Commit your changes often `git commit -m "YOUR COMMIT MESSAGE"`
+
+Your case study should be a short description of the project, including: the problem it solves, the technologies used, the approach taken, a link to the deployed project, and a link to the code on GitHub.
+
+Explain the problem and your solution in your own words, and don't just copy and paste the project brief. The point of a portfolio is to make _you stand out_, so write in your own voice. It's fine to choose something that you didn't work on all by yourself, but make sure you explain what part you did.
+
+## Git Go: Making a pull request
+
+1. Stage your files: `git add index.html style.css` . _Remember, don't `git add .` or you could add files you don't mean to._
+1. Commit your changes `git commit -m "YOUR COMMIT MESSAGE"`
+1. Push your changes to GitHub `git push origin your-name-portfolio`
+1. Open a pull request to merge your branch into `Module-HTML-CSS` . If you have the [GitHub CLI](https://cli.github.com/manual/gh_pr_create) installed, you can do this with `gh pr create --base Module-HTML-CSS --head your-name-portfolio`. Otherwise do it in the GitHub UI or your Git client.
## Acceptance Criteria
@@ -26,6 +54,6 @@ Every module, you will _iterate_ on your portfolio, adding a new project and imp
## Resources
-- [Josh Comeau on building your early career profile](https://www.youtube.com/watch?v=OXiaEXfkAec)
-- [How to Build an Effective Dev Portfolio](https://www.joshwcomeau.com/effective-portfolio/)
-- [CYF Graduate Module](https://module-graduates.codeyourfuture.io/)
+- [Powerful Git Completion with ohmyzsh](https://github.com/ohmyzsh/ohmyzsh)
+- [GitKraken](https://www.gitkraken.com/)
+- [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens/)
From 413820e72f14c34efe0fbfbbc3e41610329c3f4a Mon Sep 17 00:00:00 2001
From: Sally McGrath
Date: Mon, 27 Mar 2023 10:42:54 +0100
Subject: [PATCH 04/33] move files into dir as per readme
---
index.html => example-name-portfolio/index.html | 0
style.css => example-name-portfolio/style.css | 0
2 files changed, 0 insertions(+), 0 deletions(-)
rename index.html => example-name-portfolio/index.html (100%)
rename style.css => example-name-portfolio/style.css (100%)
diff --git a/index.html b/example-name-portfolio/index.html
similarity index 100%
rename from index.html
rename to example-name-portfolio/index.html
diff --git a/style.css b/example-name-portfolio/style.css
similarity index 100%
rename from style.css
rename to example-name-portfolio/style.css
From 15d60bfc64453b96010aa84d93129763ab708272 Mon Sep 17 00:00:00 2001
From: Sally McGrath
Date: Mon, 27 Mar 2023 10:50:33 +0100
Subject: [PATCH 05/33] clarify they may use THIS code
Just don't want everyone copypasting the Agency theme like usual
---
README.md | 14 ++++++++------
1 file changed, 8 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
index bbc02378..f6e904ca 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,10 @@
Module 1 iteration of your portfolio. We've got a lot of new concepts here so you might want to work through this in your study group, or bring to class for help.
+_Keep your changes simple!_
+
+We are using a different type of pull request workflow from your main coursework. We're doing this because we need lots of practice with Git to be ready to contribute to shared repos like professional developers. In previous cohorts, we only opened PRs to main all the way through the course, and then in Final Projects it was really hard to learn real branching and merging. So let's practice a different workflow now.
+
## Learning Objectives
- [ ] Branch from a branch in Git
@@ -10,7 +14,9 @@ Module 1 iteration of your portfolio. We've got a lot of new concepts here so yo
## Requirements
-We are using a different type of pull request workflow from your main coursework. We're doing this because we need lots of practice with Git to be ready to contribute to shared repos like professional developers. In previous years, we only opened PRs to main all the way through the course, and then in Final Projects it was really hard to learn branching and merging. So let's practice a different workflow now.
+Your case study should be a short description of the project, including: the problem it solves, the technologies used, the approach taken, a link to the deployed project, and a link to the code on GitHub.
+
+Explain the problem and your solution in your own words, and don't just copy and paste the project brief. The point of a portfolio is to make _you stand out_, so write in your own voice. It's fine to choose something that you didn't work on all by yourself, but make sure you explain what part you did.
## Git Ready: Putting our code in the right place
@@ -31,10 +37,6 @@ The instructions here are given for the command line, but you could just as easi
1. Add your files to the staging area `git add index.html style.css` . _Remember, don't `git add .` or you could add files you don't mean to._
1. Commit your changes often `git commit -m "YOUR COMMIT MESSAGE"`
-Your case study should be a short description of the project, including: the problem it solves, the technologies used, the approach taken, a link to the deployed project, and a link to the code on GitHub.
-
-Explain the problem and your solution in your own words, and don't just copy and paste the project brief. The point of a portfolio is to make _you stand out_, so write in your own voice. It's fine to choose something that you didn't work on all by yourself, but make sure you explain what part you did.
-
## Git Go: Making a pull request
1. Stage your files: `git add index.html style.css` . _Remember, don't `git add .` or you could add files you don't mean to._
@@ -45,7 +47,7 @@ Explain the problem and your solution in your own words, and don't just copy and
## Acceptance Criteria
- [ ] My portfolio introduces me and my work
-- [ ] The design and code is my own, not a template or tutorial
+- [ ] The design and code is my own, not a template or tutorial (you can use this code as a starting point)
- [ ] Each project is linked to my code on Github and the deployed project
- [ ] I have published my professional contact information on my portfolio
- [ ] My Accessibility and SEO scores are 100 on Lighthouse
From 5876e29ef56fada35c7d526a322bafe270e106d9 Mon Sep 17 00:00:00 2001
From: Barath Vignarajah
Date: Sat, 19 Oct 2024 07:23:57 +0100
Subject: [PATCH 06/33] Adding starter files
---
index.html | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++++
style.css | 57 ++++++++++++++++++++++++++++++
2 files changed, 159 insertions(+)
create mode 100644 index.html
create mode 100644 style.css
diff --git a/index.html b/index.html
new file mode 100644
index 00000000..7b0d8b5a
--- /dev/null
+++ b/index.html
@@ -0,0 +1,102 @@
+
+
+
+
+
+ My Portfolio
+
+
+
+
+
+
+
+
+
+
+
+
My Name
+
+
+
+
+
About Me
+
+ Lorem, ipsum dolor sit amet consectetur adipisicing elit. Nulla nisi
+ excepturi quidem, eum rem doloribus quam aspernatur hic enim eligendi
+ commodi minima ullam necessitatibus, cumque blanditiis, nihil magni
+ amet consectetur?
+
+
+
+
Projects Showcase
+
+ Lorem, ipsum dolor sit amet consectetur adipisicing elit. Nulla nisi
+ excepturi quidem, eum rem doloribus quam aspernatur hic enim eligendi
+ commodi minima ullam necessitatibus, cumque blanditiis, nihil magni
+ amet consectetur?
+
+
+
+
Contact me
+
+ Lorem, ipsum dolor sit amet consectetur adipisicing elit. Nulla nisi
+ excepturi quidem, eum rem doloribus quam aspernatur hic enim eligendi
+ commodi minima ullam necessitatibus, cumque blanditiis, nihil magni
+ amet consectetur?
+
- My ultimate goal is to become a full-stack software engineer, capable
- of developing robust, end-to-end systems, websites and applications
- that solve meaningful problems. I am committed to continuous learning
- and growth as I work towards this objective."
-
-
-
-
Projects Showcase
-
- Lorem, ipsum dolor sit amet consectetur adipisicing elit. Nulla nisi
- excepturi quidem, eum rem doloribus quam aspernatur hic enim eligendi
- commodi minima ullam necessitatibus, cumque blanditiis, nihil magni
- amet consectetur?
-
-
-
-
Contact me
-
- Lorem, ipsum dolor sit amet consectetur adipisicing elit. Nulla nisi
- excepturi quidem, eum rem doloribus quam aspernatur hic enim eligendi
- commodi minima ullam necessitatibus, cumque blanditiis, nihil magni
- amet consectetur?
-