bootstrap icon indicating copy to clipboard operation
bootstrap copied to clipboard

docs: add Sass deprecations notice in docs

Open MaxLardenois opened this issue 9 months ago • 1 comments

Description

This PR will add a callout in the docs to explain and provide links to potential resolution regarding Sass depreciation. Also it modifies Vite, Parcel and Webpack configs to silence the deprecations warnings from Dart Sass.

Motivation & Context

Many issues are opened regarding the Sass deprecation notices (see #40962) and users must search the web to pinpoint the problem and potential workarounds, adding a callout directly in the docs while the core team is working on node Sass exit would be helpful for users and would limit erroneous new issues opening about these deprecations. We have the same problems with our company's fork's users who must search the web for information about these issues but we figured it could be an improvement on Bootstrap docs directly.

Type of changes

  • [ ] Bug fix (non-breaking change which fixes an issue)
  • [ ] New feature (non-breaking change which adds functionality)
  • [ ] Refactoring (non-breaking change)
  • [ ] Breaking change (fix or feature that would change existing functionality)

Checklist

  • [x] I have read the contributing guidelines
  • [x] My code follows the code style of the project (using npm run lint)
  • [x] My change introduces changes to the documentation
  • [ ] I have updated the documentation accordingly
  • [ ] I have added tests to cover my changes
  • [ ] All new and existing tests passed

Live previews

Related issues

#40962

MaxLardenois avatar Mar 10 '25 09:03 MaxLardenois

Thanks for this PR, @MaxLardenois! I haven’t reviewed the exact wording and modifications in detail, but I’m not opposed to adding it temporarily to our documentation. However, we need to carefully coordinate the merge of this PR with our upcoming releases. If we want this change to be useful in time, it should be included in v5.3.4. Additionally, if this is merged, we’ll need to update twbs/examples accordingly. @mdo, what do you think? Should I help move this PR forward?

julien-deramond avatar Mar 10 '25 16:03 julien-deramond