-
Notifications
You must be signed in to change notification settings - Fork 194
USWDS-Site - Settings: Fix code audit issues #2016
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
…dit-settings-fix
{% for type in setting.type %} | ||
<span class="margin-bottom-05"> | ||
{% include get-token-url.html token=type %} | ||
</span> | ||
{% endfor %} |

There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This allows for multiple token types to be declared. Useful for tokens like $theme-collection-header-typeset
that need to declare three different tokens in one setting.
{% include get-token-url.html token=entry.kind %} | ||
{% include get-token-url.html token=entry.type %} | ||
</span> | ||
</td> | ||
<td data-title="{{ col5Title }}" class="{{ col5Width }} display-inline-flex flex-align-start"> | ||
<span class="font-lang-3xs"> | ||
{{ entry.usage | markdownify }} | ||
{{ entry.description | markdownify }} |

There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This fixes the broken token types on mapped items.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great findings and work here! Besides being compliant with 3.3.0, I think this also helps our settings to be better understood!
Tested by:
- Comparing the live site to branch build
- Cross-referencing audit findings spreadsheet with USWDS settings
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Overall looks good, added some comments/questions for potential improvements.
Also found some legacy typo's I was hoping we could fix in this PR. Thank you!
Summary
Resolved inconsistencies with what is found in USWDS.
Related issue
Closes #2009
Preview link
Preview link: Settings page
Problem statement
The code documentation audit revealed several inconsistencies with the settings in USWDS 3.3.0.
Individual issues have been itemized in the Code documentation audit spreadsheet (Google sheets) 🔒
Solution
Update settings documentation to accurately reflect what is in the current version USWDS.
⚠️ This does not include any changes included in the forthcoming 3.4.0 release.
Tasks completed
settings.yml
since it doesn't appear to be used.settings-table.html
to show types in mapssettings-table.html
to show token types when multiple token types are usedOutstanding questions
$theme-prose-font-family
be moved to the components section?[token name]
,[token value]
line from$[utility-module]-manual-values
?Testing and review