HTML Practice: Build an FAQ with Native Disclosures

Ready to build something with HTML? In this exercise you will write an FAQ where each question is a summary inside a details element. This is practice, so the goal is to understand your choices rather than just copy a finished design.

You can use a plain text editor and any current browser. Create a separate project folder and save your page as index.html unless the task calls for several pages. You do not need to finish every improvement on the first try. A small valid page is a better starting point than a complicated page that nobody can use.

What you will build

• Organize the content into a clear page title and sections related to the assignment
• Implement the feature described in the brief: write an FAQ where each question is a summary inside a details element
• The summary is the clickable question; the answer belongs inside details
• Native disclosure controls work with keyboard activation

Step 1: Plan the page

Before writing code, list the content your visitor needs to understand or complete the task. Mark the page title, navigation, major sections, and interactive parts. If the visitor should fill in a form, decide which fields are truly necessary. If the visitor needs to compare data, identify your row and column headings first.

Step 2: Start with working HTML

The following starter example focuses on the central HTML technique used in this project. Type it into a file, run it in your browser, and then expand it to meet the requirements above. The starter is not presented as the entire finished assignment.

<section>
    <h1>Frequently asked questions</h1>
    <details name="help-faq">
        <summary>How do I start?</summary>
        <p>Choose your first lesson from the course list.</p>
    </details>
    <details name="help-faq">
        <summary>Can I study on a phone?</summary>
        <p>Yes. You can read the lessons on a mobile browser.</p>
    </details>
</section>

Step 3: Understand what the example does

• The summary is the clickable question; the answer belongs inside details.
• Native disclosure controls work with keyboard activation.
• Shared name values can create exclusive disclosure groups in compatible browsers.

All file names and text are teaching examples. Replace placeholders with real files and meaningful project content.

Step 4: Finish the project

1. Replace the example words and sample data with your own original content that fits the assignment.
2. Add every section and control described in the project goals. Keep a clear heading order and meaningful labels.
3. Save your work, open it in a browser, and check actual behavior with both mouse and keyboard.
4. Check that linked files, images, form destinations, and IDs really exist; fix any broken paths or duplicate identifiers.
5. If JavaScript, a web server, or another asset is necessary, add it explicitly or explain what remains a demonstration.

How to check your finished work

• The page clearly communicates its topic without relying on decorative styling.
• Headings are in a logical order, and important information remains readable at 200% zoom.
• Links and buttons work with the keyboard and have understandable labels.
• Images and media have appropriate accessible text alternatives; tabular data has proper header associations.
• The project-specific requirement is met: Write an FAQ where each question is a summary inside a details element
• Any HTML validator warnings or browser console problems have been reviewed and fixed.

Common Beginner Mistakes

• Do not hide the only important instructions inside a collapsed region.
• Skipping testing because the page looks correct at one window size.
• Using placeholder data or missing resources in a project presented as complete.

Key Takeaways

• The goal is to write an FAQ where each question is a summary inside a details element.
• The summary is the clickable question; the answer belongs inside details.
• A successful project is understandable, valid, accessible, and tested—not merely visually attractive.