Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

USWDS-Tutorial - Bug: Inconsistent reference to theme directory in gulpfile.js

Open Beginner friendly
#74 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
90/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript
Domain
documentation

Research direction

Start by locating the tutorial content for Part Two, Step 7 and Part Seven, Step 3, then compare the gulpfile.js examples. Correct the inconsistent theme directory reference so both steps use the intended value, and verify the surrounding instructions remain consistent.

Written by the indexing model from the issue text.

Description

Needs: Confirmation Status: Triage Type: Bug
Describe the bug

In the instructions, in Part Two, Step 7, you instruct us to set the theme path in gulpfile.js:
uswds.paths.dist.theme = './_theme';

Later, in Part Seven, Step 3, the value is displayed while instructing us to set the project Sass source directory in the gulpfile.js but the value has had the initial underscore removed:

uswds.paths.dist.theme = './theme';
uswds.paths.src.projectSass = './assets/css';
Steps to reproduce the bug
  1. Go to Part Two, Step 7 and note the value of the theme directory being set.
  2. Go to Part Seven, Step 3, and not the value displayed for the same setting being different than above.
Expected Behavior
  1. Expect that values between steps that we aren't told to change remain the same for consistency sake and reduce confusion.
Related code

No response

Screenshots

Part Two, Step 7, the setting of the value:
Image

Part Two, Step 8, showing the value again in context of step 8's additions:
Image

Part Seven, Step 3, showing the value again in the context of the change, but its different than before:
Image

System setup
  • USWDS Version: 3.14.0
  • Device: Laptop
  • Operating System: Windows 11 Enterprise
  • Browser and version: Chrome Version 153.0.8010.54 (Official Build) (64-bit)
Additional context

I believe -- and sincerely hope -- that this is a simple typo which led to consistency between the steps.

Code of Conduct
Dominant language
HTML
Stars
45
Forks
36
Avg merge
15m
Merged PRs (30d)
3

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from uswds/uswds-tutorial

All issues in uswds/uswds-tutorial

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.