Skip to content

6.2.0 content changes#615

Open
romaricpascal wants to merge 7 commits into
mainfrom
feature/sass-modules
Open

6.2.0 content changes#615
romaricpascal wants to merge 7 commits into
mainfrom
feature/sass-modules

Conversation

@romaricpascal
Copy link
Copy Markdown
Member

@romaricpascal romaricpascal commented Apr 23, 2026

PR for gathering the content changes for the 6.2.0 release that'll bring in our use and support for Sass module.

The branch currently runs against a preview release of the feature/sass-modules branch of GOV.UK Frontend.

Preview of the Sass API reference - Original Sass API reference (note that the disparition of Objects is expected as the govuk-width-container mixin has been moved to helpers).

@romaricpascal romaricpascal requested a review from a team as a code owner April 23, 2026 18:15
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 23, 2026

Deploy Preview for govuk-frontend-docs-preview ready!

Name Link
🔨 Latest commit 572e22f
🔍 Latest deploy log https://app.netlify.com/projects/govuk-frontend-docs-preview/deploys/69f1cfdf8afadc0008afb156
😎 Deploy Preview https://deploy-preview-615--govuk-frontend-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@romaricpascal
Copy link
Copy Markdown
Member Author

romaricpascal commented Apr 23, 2026

The Sass API compiled OK, the govuk-width-container mixin is appropriately listed in the helpers section now.

Only hiccup seems to be the duplication of the settings for the buttons, I think because they're documented in both the components/button/_settings.scss and components/button/_settings.import.scss. I propose we only document them in the module, and not in the import-only file.

On the bright side, all the new internal mixins to support both @import and @use are not appearing in the Sass Doc (but we should still explicitly mark them private for clarity) 🎉

Diff of the HTML from the two pages

@domoscargin domoscargin linked an issue Apr 28, 2026 that may be closed by this pull request
1 task
v6.2.0 adds import only files in GOV.UK Frontend, some of which have duplicate the Sass documentation from their corresponding Sass module. To avoid duplicating entries in the Sass API, we use a `sassdoc.config.json` file to exclude the `.import.scss` file.

Unfortunately, there's [no flag for Sassdoc's CLI to exclude files](http://sassdoc.com/getting-started/#options) and working out a glob pattern would make things a little cryptic.
@domoscargin domoscargin force-pushed the feature/sass-modules branch from eb17bdf to 4f9178d Compare April 29, 2026 08:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation updates for sass modules for 6.2.0-beta.0

2 participants