DiscoveryVIP / HTML & CSS AcademyHelp

94. Maintainable HTML and CSS projects

Module 19 · About 20 minutes · Lesson 93; review earlier concepts as needed

Open Interactive Lesson

Discover

What changes when you use maintainable html and css projects, and how can you prove it?

Predict

Record the expected structure or visual change before rendering. Name one thing that should remain unchanged.

Understand

Separate content, reusable styling and optional behavior into named files. Use descriptive classes and local relative paths, and document the project’s assumptions. A shared stylesheet supports consistency across multiple pages. Renaming a file requires reviewing all references; the Build Studio reports broken internal links rather than pretending a renamed destination still exists.

Important source lines

index.html:1 <main class="page"><h1>Project organization</h1><section class="feature"><h2>One responsibility per layer</h2><p>Keep source easy to find.</p></section></main>
The document’s principal content, normally one visible instance. Attribute guidance: id useful for skip links.
styles.css:1 .page { max-width:70rem; margin-inline:auto; padding:1rem; } .feature { padding-block:2rem; }
Constrains the maximum width without requiring a fixed width. Accepted grammar: none | <length-percentage [0,∞]> | min-content | max-content | fit-content | fit-content(<length-percentage [0,∞]>) | <calc-size()> | <anchor-size()>. Context: block.

The first example teaches this lesson’s primary contract. Additional examples are optional related references or applications, each with its own purpose and source; an example without an authored check requires the stated visual/manual review.

Example 1: Maintainable HTML and CSS projects

A reusable descriptive class connects a meaningful content section to its styling.

index.html

<main class="page"><h1>Project organization</h1><section class="feature"><h2>One responsibility per layer</h2><p>Keep source easy to find.</p></section></main>

styles.css

.page { max-width:70rem; margin-inline:auto; padding:1rem; } .feature { padding-block:2rem; }

script.js

Expected: A reusable descriptive class connects a meaningful content section to its styling.

Edit and Render This Example
Example 2: Property: max-width

Constrains the maximum width without requiring a fixed width.

index.html

<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>

styles.css

body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }
.sample { max-width: 28rem; }

script.js

Expected: Inspect .sample in the block context. Constrains the maximum width without requiring a fixed width. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.

Edit and Render This Example
Example 3: Property: padding

Creates internal space between content and border.

index.html

<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>

styles.css

body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }
.sample { padding: 24px; }

script.js

Expected: Inspect .sample in the block context. Creates internal space between content and border. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.

Edit and Render This Example
Example 4: Property: padding-block

Sets internal spacing on logical block edges.

index.html

<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>

styles.css

body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }
.sample { padding-block: 16px; }

script.js

Expected: Inspect .sample in the block context. Sets internal spacing on logical block edges. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.

Edit and Render This Example
Example 5: Property: margin-inline

Can center an appropriately sized block along the inline axis.

index.html

<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>

styles.css

body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }
.sample { margin-inline: auto; }

script.js

Expected: Inspect .sample in the block context. Can center an appropriately sized block along the inline axis. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.

Edit and Render This Example

Build and test

A reusable descriptive class connects a meaningful content section to its styling. Repair the current exercise without removing necessary content. Checks inspect the stated structural/computed/stylesheet contract, not exact source text.

Starter index.html

<main class="page"><h1>Project organization</h1><section class="wrong"><h2>One responsibility per layer</h2><p>Keep source easy to find.</p></section></main>

Starter styles.css

.page { max-width:70rem; margin-inline:auto; padding:1rem; } .feature { padding-block:2rem; }

Objective contract

[
  {
    "type": "count",
    "selector": "main.page .feature",
    "value": 1,
    "label": "Include 1 matching main.page .feature element(s)"
  }
]
Hint 1

Locate the first difference between the intended result and the real preview. Inspect matching elements and computed styles.

Hint 2

The relevant source uses class="feature". The exercise instead uses class="wrong". Identify its effect before changing it.

Hint 3

Restore the intended class="feature" operation or implement an equivalent structure/style. Run the actual checks and explain why it works.

Complete reference solution

index.html

<main class="page"><h1>Project organization</h1><section class="feature"><h2>One responsibility per layer</h2><p>Keep source easy to find.</p></section></main>

styles.css

.page { max-width:70rem; margin-inline:auto; padding:1rem; } .feature { padding-block:2rem; }

Explain, reflect and extend

Which part of the actual preview or inspector proves this result? Explain one boundary case and name what automated checks do not verify.

Apply this concept to a different realistic piece of content. Predict its structure or visual behavior, test narrow and wide widths where relevant, then record one invalid case and its repair.

Troubleshooting and professional practice

If nothing changes, confirm that you edited the active file and ran Run Preview, or enabled Auto Preview. Inspect the actual DOM because the browser may repair invalid nesting. For CSS, check selector matches, valid declarations, active queries and computed values. Preserve local asset paths and inspect warnings. A reusable descriptive class connects a meaningful content section to its styling.

Knowledge check

Explain why the stated result follows from the source. Predict a second input or width and test it independently. Automated contracts and written explanations are reviewed separately.

Optional AI prompts

  1. Explain this lesson’s source line by line using the actual objective above.
  2. Help implement one small extension and define normal, boundary and failure tests.
  3. Review/debug the source against actual preview observations; verify standards and never claim rendering without evidence.

Continue to Lesson 95: AI-assisted website development

Detailed learning and editor help · Standards reference