Unit 09 · lesson
Portfolio Architecture Defense
This is the final checkpoint.
You are not presenting every CSS rule.
You are defending the architecture and evidence behind a real published Jekyll site.
Opening claim
In two minutes or less, explain:
- what the portfolio is for;
- who it serves;
- why Jekyll fits the project;
- the main source-to-public pipeline.
Architecture walkthrough
Use your diagram to explain:
content
→ Liquid/templates
→ configuration/dependencies
→ Jekyll rendering/build
→ generated site
→ Git/GitHub
→ Pages deployment
→ browser
Use your actual architecture, not a memorized generic diagram.
Page trace
Choose one real project page and show:
- source document;
- front matter;
- content model;
- layout/include chain;
- generated output;
- public URL;
- source commit.
Decision defense
Be ready to answer:
- Why a collection for projects?
- Why custom layouts or a theme?
- Why did you keep/reject a plugin?
- Why this deployment mode?
- What did you prioritize for accessibility/privacy?
Failure defense
Describe one failure without jumping to the fix.
State:
symptom
surviving behavior
failed evidence
bounded diagnosis
repair
verification
Change request
A reviewer may give you one new scenario:
- add another project;
- change repository path/baseurl;
- remove a plugin;
- rename a permalink;
- theme update changes markup;
- image missing in production.
Explain which source/configuration/deployment boundaries would be affected before proposing edits.
Final evidence
Submit or preserve:
- published portfolio;
- source repository;
- review-candidate commit;
- architecture diagram;
- evidence dossier;
- quality audit;
- failure/recovery evidence;
- decision records; and
- final defense notes/recording if required.
The standard
You have completed the course when the site is not just something you made.
It is something you can read, rebuild, debug, deploy, and explain.