Learning Articles
TL;DR: Deep dive articles you can read start to finish when you want to really understand a topic, not just look up a rule.
The Style Guides section gives you a rule to follow. This section is different. It helps you understand why the rule exists, step by step. Read one of these when you have twenty minutes and want to go deeper than a quick reference page.
What’s on this page group
Section titled “What’s on this page group”- Liquid Global Objects Reference : a detailed tour of the objects you’ll use every day.
- Writing Maintainable Code at Scale : what actually keeps a theme codebase easy to work with in year three, not just in week one.
The CSS deep dive (cascade, specificity, and the box model) moved into its own CSS section, specifically Cascade, Specificity & the Box Model, alongside everything else CSS-related. The JavaScript & Web Components deep dive moved into its own JavaScript section, specifically Custom Element Lifecycle & Progressive Enhancement, alongside everything else JS-related. Locale file management moved to its own Internationalization & Locales section, alongside the Theme Store’s i18n/RTL requirements, since translation work spans both.
How to use this section
Section titled “How to use this section”These are not reference pages you bookmark for quick daily lookups. That’s what Reference is for. These pages are meant to be read start to finish, once, when you want to really understand a topic instead of just checking a rule. If you’re a new teammate, try reading these in roughly the order listed above during your onboarding, alongside Getting Started.
Key takeaways
Section titled “Key takeaways”- Liquid Global Objects · Writing Maintainable Code at Scale
- For the CSS deep dive: see CSS. For the JS & Web Components deep dive: see JavaScript.
- This section helps you understand why something works the way it does. Style Guides gives you the rule. Reference is for quick lookups.