danog/dart-sass
1
0
Fork 0
mirror of https://github.com/danog/dart-sass.git synced 2024-11-26 12:14:42 +01:00
Code Issues Packages Projects Releases Wiki Activity

Move behavior differences into the README.

Browse Source
This commit is contained in:
Natalie Weizenbaum 2016-10-07 15:29:42 -07:00
parent 483305e7bc
commit dda33e73a1
2 changed files with 31 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@ -37,4 +37,35 @@ implementation of the Sass language. It has a number of advantages:
[perf]: https://github.com/sass/dart-sass/blob/master/perf.md [perf]: https://github.com/sass/dart-sass/blob/master/perf.md
## Behavioral Differences
There are a few intentional behavioral differences between Dart Sass and Ruby
Sass. These are generally places where Ruby Sass has an undesired behavior, and
it's substantially easier to implement the correct behavior than it would be to
implement compatible behavior. These should all have tracking bugs against Ruby
Sass to update the reference behavior.
1. `@extend` only accepts simple selectors, as does the second argument of
`selector-extend()`. See [issue 1599][].
2. Subject selectors are not supported. See [issue 1126][].
3. Pseudo selector arguments are parsed as `<declaration-value>`s rather than
having a more limited custom parsing. See [issue 2120][].
4. The numeric precision is set to 10. See [issue 1122][].
5. The indented syntax parser is more flexible: it doesn't require consistent
indentation across the whole document. This doesn't have an issue yet; I need
to talk to Chris to determine if it's actually the right way forward.
6. Colors do not support channel-by-channel arithmetic. See [issue 2144][].
[issue 1599]: https://github.com/sass/sass/issues/1599
[issue 1126]: https://github.com/sass/sass/issues/1126
[issue 2120]: https://github.com/sass/sass/issues/2120
[issue 1122]: https://github.com/sass/sass/issues/1122
[issue 2144]: https://github.com/sass/sass/issues/2144
Disclaimer: this is not an official Google product. Disclaimer: this is not an official Google product.

28
differences.md
View File

@ -84,31 +84,3 @@ Dart Sass for developers familiar with Ruby Sass.
that must be parsed out. In addition, newlines are *never* preserved within that must be parsed out. In addition, newlines are *never* preserved within
complex selectors; in general, selectors should be short enough that this complex selectors; in general, selectors should be short enough that this
isn't an issue. isn't an issue.
There are also some intentional behavioral differences. These are generally
places where Ruby Sass has an undesired behavior, and it's substantially easier
to implement the correct behavior than it would be to implement compatible
behavior. These should all have tracking bugs against Ruby Sass to update the
official behavior.
1. `@extend` only accepts simple selectors, as does the second argument of
`selector-extend()`. See [issue 1599][].
2. Subject selectors are not supported. See [issue 1126][].
3. Pseudo selector arguments are parsed as `<declaration-value>`s rather than
having a more limited custom parsing. See [issue 2120][].
4. The numeric precision is set to 10. See [issue 1122][].
5. The indented syntax parser is more flexible: it doesn't require consistent
indentation across the whole document. This doesn't have an issue yet; I need
to talk to Chris to determine if it's actually the right way forward.
6. Colors do not support channel-by-channel arithmetic. See [issue 2144][].
[issue 1599]: https://github.com/sass/sass/issues/1599
[issue 1126]: https://github.com/sass/sass/issues/1126
[issue 2120]: https://github.com/sass/sass/issues/2120
[issue 1122]: https://github.com/sass/sass/issues/1122
[issue 2144]: https://github.com/sass/sass/issues/2144