README.md in sassc-embedded-1.68.2 vs README.md in sassc-embedded-1.68.3
- old
+ new
@@ -7,60 +7,21 @@
This library shims [`sassc`](https://github.com/sass/sassc-ruby) with the [`sass-embedded`](https://github.com/ntkme/sass-embedded-host-ruby) implementation.
It has been tested with:
+- [`bootstrap`](https://github.com/twbs/bootstrap-rubygem)
- [`sassc`](https://github.com/sass/sassc-ruby)
- [`sassc-rails`](https://github.com/sass/sassc-rails)
- [`sprockets`](https://github.com/rails/sprockets)
- [`sprockets-rails`](https://github.com/rails/sprockets-rails)
-## Uninstall `sassc`
+## Install
-Execute:
-
-``` sh
-bundle remove sassc
-```
-
-Or uninstall it yourself as:
-
-``` sh
-gem uninstall sassc
-```
-
-**If your application has a transitive dependency on `sassc` that cannot be removed, you can use any of the following workarounds.**
-
-### Workaround One
-
Add this line to your application's Gemfile:
``` ruby
-gem 'sassc', github: 'sass/sassc-ruby', ref: 'refs/pull/233/head'
-```
-
-And then execute:
-
-``` sh
-bundle
-```
-
-The fork of `sassc` at https://github.com/sass/sassc-ruby/pull/233 will load the shim automatically when `require 'sassc'` is invoked, meaning no other code changes needed in your application.
-
-### Workaround Two
-
-Add this line to your application's code:
-
-``` ruby
-require 'sassc-embedded'
-```
-
-## Install `sassc-embedded`
-
-Add this line to your application's Gemfile:
-
-``` ruby
gem 'sassc-embedded'
```
And then execute:
@@ -93,5 +54,47 @@
2. Option `:precision` is ignored.
3. Option `:line_comments` is ignored.
See [the dart-sass documentation](https://github.com/sass/dart-sass#behavioral-differences-from-ruby-sass) for other differences.
+
+## Troubleshooting
+
+### The original `sassc` gem is still being used instead of `sassc-embedded`
+
+When launching an application via `bundle exec`, it puts `sassc-embedded` at higher priority than `sassc` in `$LOAD_PATH`. You can verify the order of `$LOAD_PATH` with the following command:
+
+``` ruby
+bundle exec ruby -e 'puts $LOAD_PATH'
+```
+
+If you see `sassc` has higher priority than `sassc-embedded`, try remove `sassc`:
+
+```
+bundle remove sassc
+```
+
+If your application has a transitive dependency on `sassc` that cannot be removed, you can use one of the following workarounds.
+
+#### Workaround One
+
+Add this line to your application's Gemfile:
+
+``` ruby
+gem 'sassc', github: 'sass/sassc-ruby', ref: 'refs/pull/233/head'
+```
+
+And then execute:
+
+``` sh
+bundle
+```
+
+The fork of `sassc` at https://github.com/sass/sassc-ruby/pull/233 will load the shim whenever `require 'sassc'` is invoked, meaning no other code changes needed in your application.
+
+#### Workaround Two
+
+Add this line to your application's code:
+
+``` ruby
+require 'sassc-embedded'
+```