Commit Graph

567 Commits

Author SHA1 Message Date
Natalie Weizenbaum
3cde415281 Document the Sass migrator
Closes #358
2019-09-25 14:53:13 +01:00
Natalie Weizenbaum
4a02f04717 Document new built-in functions
Closes #365
2019-09-24 11:36:43 +01:00
Natalie Weizenbaum
a99bb65fd6 The keywords() function is actually in sass:meta, not sass:map 2019-09-10 16:31:02 -07:00
Natalie Weizenbaum
35c719d1bb
Document how @extend interacts with modules (#369)
This includes documenting private placeholder selectors.

Closes #360
2019-09-09 15:24:51 -07:00
Natalie Weizenbaum
d8c3238c79
Document @forward (#368)
Closes #362
2019-09-06 14:13:51 -07:00
Natalie Weizenbaum
d46c2c77b0 Fix broken links 2019-09-05 14:47:14 -07:00
Natalie Weizenbaum
576474cfc5 Code review changes 2019-09-05 14:39:50 -07:00
Natalie Weizenbaum
b1b07540f2 Module-ify built-in function documentation
Closes #363
2019-09-04 17:56:16 -07:00
Natalie Weizenbaum
df428f62b2 Move plain-CSS function documentation into at-rules/function
This isn't ideal, since these functions aren't defined with @function,
but there's not really a better place to put it. It certainly doesn't
make sense in the built-in module documentation anymore.
2019-09-04 15:24:22 -07:00
Natalie Weizenbaum
029520349a Rename /documentation/functions to /documentation/modules
This hierarchy is now going to document built-in modules, which mostly
contain functions but can also contain mixins and may potentially
contain variables in the future.
2019-09-04 15:24:22 -07:00
Natalie Weizenbaum
8277f5bfbe Code review changes 2019-09-03 16:50:47 -07:00
Natalie Weizenbaum
8f093ba74b Document the @use rule
Closes #361
2019-09-02 13:45:40 -07:00
Natalie Weizenbaum
2088a021f9
Add an implementation note about sass/libsass#2957 (#359)
Documentation for @use and @forward themselves will come in a future
PR.

Partially addresses #263
2019-08-29 15:31:29 -07:00
Natalie Weizenbaum
835ff5a6a0
Add an implementation note about sass/libsass#2957 (#356) 2019-08-05 22:43:23 -07:00
Sergey Fetiskin
782d09c9cc fix to correct version of libsass (#355) 2019-07-22 23:54:17 +01:00
Natalie Weizenbaum
8b24f60f95
Add a breaking change page for /-as-division (#353)
This is intentionally not linked anywhere yet. It exists as a landing
page for links from dev versions of Sass and the migrator, and will be
updated as phase 1 comes closer to launching.

See sass/sass#2565
2019-06-06 19:37:59 +01:00
Natalie Weizenbaum
256a1bc7d0
Fix a broken code example (#352)
Closes #351
2019-06-06 19:36:46 +01:00
Natalie Weizenbaum
e378b285ef
Tweak some phrasing 2019-06-06 16:45:50 +01:00
Natalie Weizenbaum
a8dd640239 Add a breaking change page for /-as-division
This is intentionally not linked anywhere yet. It exists as a landing
page for links from dev versions of Sass and the migrator, and will be
updated as phase 1 comes closer to launching.

See sass/sass#2565
2019-06-04 15:11:33 +01:00
Natalie Weizenbaum
990651f774
Add documentation for recent breaking changes (#350)
We'll eventually add upcoming breaking changes, like /-as-division, as
well.
2019-06-04 12:57:17 +01:00
Natalie Weizenbaum
7bca65c349
Update the copyright line (#348) 2019-05-31 12:05:02 +01:00
Natalie Weizenbaum
ba4cdf8836
Merge pull request #346 from sass/ruby-sass-cli
Update Ruby Sass's status in the Ruby Sass CLI docs
2019-05-30 05:24:38 -07:00
Natalie Weizenbaum
7a2aa57b96
Make "/" and "s" focus the search bar (#347)
Closes #345
2019-05-30 04:30:10 -07:00
Natalie Weizenbaum
dd98c98307 Update Ruby Sass's status in the Ruby Sass CLI docs 2019-05-24 15:46:00 -07:00
Adrian
cfac02476e add reference to LibSass Host .net wrapper (#343) 2019-05-21 13:40:29 -07:00
Natalie Weizenbaum
854167dd0f
More clearly document import order (#342) 2019-05-16 16:15:53 -07:00
Galdor Takacs
fe63cfa534 styleguide/code: Remove obsolete line forgotten in 92d9baf850 2019-05-10 05:37:51 +02:00
Natalie Weizenbaum
084e181580 Make all client-side redirect URLs absolute
These used to redirect from /documentation/, but we tweaked the way
URLs work and now they redirect from /documentation. Making them
absolute avoids even the potential for that breakage.
2019-05-08 13:19:25 -07:00
Natalie Weizenbaum
79097d0fe1 Bundle all JS into a single file
Because we weren't doing this yet, we weren't actually loading the
redirect.js JS code at all.

This also gets rid of some unused JS.
2019-05-08 13:01:20 -07:00
Natalie Weizenbaum
9b82b23abf
Fix a broken function example (#336)
A "min" function conflicts with Sass's support for CSS's min() syntax.

Closes #335
2019-05-06 14:32:23 -07:00
Natalie Weizenbaum
ff7970b80e
Merge pull request #334 from sass/error-css
Document Dart Sass's --error-css flag
2019-05-06 13:56:47 -07:00
Maarten Brouwers
c582c015b2 Fix code example (#339)
Minor fix: `to-lower-case` featured a `to-upper-case` example
2019-05-06 11:40:07 -07:00
​Faizaan
a41d9df7ef Remove duplicate section about mixins (#337) 2019-05-03 13:00:10 -07:00
Natalie Weizenbaum
c932e18338 Document Dart Sass's --error-css flag
See sass/dart-sass#657
See sass/dart-sass#659
2019-04-30 11:16:26 -07:00
Natalie Weizenbaum
bbdac76437 Add starting versions for Dart CLI features
I'm leaving these out for features that have been supported since
1.0.0, since they're available in effectively all versions.
2019-04-30 11:05:53 -07:00
Natalie Weizenbaum
6729c6fb54
Explicitly document the @keyframes rule (#333)
I didn't originally think that this was complex enough to need
documenting, but it looks like people are searching for it so I guess
it does.
2019-04-30 10:38:29 -07:00
Natalie Weizenbaum
8c62ec4ccc
Remove duplicated sections in /guide (#331)
Closes #328
2019-04-29 16:06:32 -07:00
Natalie Weizenbaum
3de6939d9b
Fix a small error in an example (#332)
Closes #329
2019-04-29 16:06:25 -07:00
Natalie Weizenbaum
757590f95a Remove duplicated sections in /guide
Closes #328
2019-04-25 11:31:38 -07:00
Natalie Weizenbaum
eeef4e2f6c
Merge pull request #325 from sass/merge
Merge branch 'master' into wip.reference
2019-04-22 14:13:43 -07:00
Natalie Weizenbaum
03bc54bca2 Make search result URLs always point to the current site 2019-04-17 17:49:03 -07:00
Natalie Weizenbaum
891f6e7d95 Merge branch 'master' into wip.reference 2019-04-17 17:42:31 -07:00
Natalie Weizenbaum
05d3c9121d Make search result URLs always point to the current site 2019-04-17 17:29:12 -07:00
Natalie Weizenbaum
b75fca5a61 Make text in collapsible navs unselectable
This ensures that quickly opening and closing a nav doesn't
accidentally select its text.
2019-04-17 12:59:38 -07:00
Natalie Weizenbaum
b771e2297e Avoid an unstyled rendering moment with code examples
This renders the tabs and all the jQuery classes server-side, so that
the code examples are rendered correctly on the page's first load
rather than waiting for the JavaScript to activate. This also has a
side effect of making them look correct with JavaScript disabled.

This also adds a little additional styling in the noscript stylesheet
to make code examples look better on a narrow viewport with JavaScript
disabled.
2019-04-12 02:12:00 -07:00
Natalie Weizenbaum
e7ffef4fc9 Avoid an unstyled rendering moment with the tables of contents
Tables of contents are now statically rendered in their appropriately
open/closed states, rather than updated via JavaScript, so they render
correctly on the first page load. In order to make the "page sections"
table still usable without JS, this adds a stylesheet in a <noscript>
tag that forces the sections into an open state.
2019-04-12 00:09:10 -07:00
Natalie Weizenbaum
ce9244b504
Tweak typography to improve legibility (#318)
* Add more margin above headers to visually associate them with the
  prose below, rather than above.

* Reduce the margin around normal block elements to more clearly
  associate them with one another.

* Increase the size of prose and medium/large headers to make them
  easier to see.

* Reduce the font weight of intro paragraphs to make them more
  visually distinct from the rest of the documentation.

Based on @slimekat's suggestions.

Closes #313
2019-04-11 15:30:17 -07:00
Natalie Weizenbaum
de561b2370
Make the reference tables of contents collapsible (#320) 2019-04-11 15:30:10 -07:00
Natalie Weizenbaum
d87eeab0a3 Update Dart Sass error examples to match the current output 2019-04-07 17:01:48 -07:00
Natalie Weizenbaum
96632b9c02 Document the --unicode flag
See sass/dart-sass#566
2019-04-07 16:43:49 -07:00
Natalie Weizenbaum
bfff691df2 Document the --no-charset flag
See sass/dart-sass#644
2019-04-07 16:39:53 -07:00
Natalie Weizenbaum
7120ef2432
Indicate that Ruby Sass is end-of-life (#319)
Closes #206
2019-04-05 15:48:12 -07:00
Natalie Weizenbaum
bf21b7f160
Merge pull request #317 from sass/adjacent-tabs
Render syntax examples using adjacent tabs if they're narrow enough

Closes #311
2019-04-04 23:56:06 -07:00
Natalie Weizenbaum
4b6b15b1ab
Add special styling for intro pages (#316)
This just bumps up the font size a bit, to help emphasize that these
pages are special and make them look less bare.

Closes #276
2019-04-04 23:55:07 -07:00
Natalie Weizenbaum
d42fca01ff Remove the Maps introduction paragraph
This code examples in this paragraph don't fit in the larger font
size.
2019-04-03 16:39:35 -07:00
Natalie Weizenbaum
3d20c8f536 Fix some broken Markdown links 2019-04-03 16:38:26 -07:00
Natalie Weizenbaum
be95e0c7df Allow examples to split even if they can't split in the middle 2019-03-28 19:13:31 -07:00
Natalie Weizenbaum
f56c48cafc Render syntax examples using adjacent tabs if they're narrow enough
Closes #311
2019-03-28 19:13:22 -07:00
Natalie Weizenbaum
31ade4eebd Don't make syntax switcher arrows invisible in callouts (#312)
I'm not sure why this was done initially, but it seems wrong?
2019-03-20 03:47:13 +02:00
Natalie Weizenbaum
e22698388e
Merge branch 'wip.reference' into function-return 2019-03-19 13:40:00 -07:00
Natalie Weizenbaum
78429ae1b4
Add permalink icons to function API docs (#309)
Closes #308
2019-03-18 17:49:03 -07:00
Natalie Weizenbaum
4e6eb090a4
Merge pull request #306 from sass/impl-status
Tweak impl status styling
2019-03-18 17:48:47 -07:00
Natalie Weizenbaum
e3eb8cc442 Clarify that multiple / operations aren't treated as divison
Closes #303
2019-03-11 17:38:45 -07:00
Natalie Weizenbaum
b8fd618da7 Document forbidden assignment to non-existent global variables
Closes #285
2019-03-11 17:37:27 -07:00
Natalie Weizenbaum
36a1610c62 Always select SCSS by default 2019-03-11 02:02:38 -07:00
Natalie Weizenbaum
1d718a3fb3
Merge branch 'wip.reference' into function-return 2019-03-10 23:23:00 -07:00
Natalie Weizenbaum
d0c1079b78
Merge branch 'wip.reference' into impl-status 2019-03-10 23:22:02 -07:00
Natalie Weizenbaum
3b1a93afe9 Add a light border to callouts (#300)
This helps them stand out a tiny bit more, especially in functions
where their backgrounds are very similar to the function background.
2019-03-10 09:11:48 -05:00
Natalie Weizenbaum
f24f5927cd Fix the whitespace above code examples once and for all (#304)
Closes #302
2019-03-10 09:10:50 -05:00
Natalie Weizenbaum
0ce28695ce Fix broken links 2019-03-08 17:57:33 -08:00
Natalie Weizenbaum
4c58ef0739 Add a partial support state for impl statuses 2019-03-08 17:11:11 -08:00
Natalie Weizenbaum
482542ac08 Add a header for impl status bars
This gives us a place to disambiguate between implementation statuses
that refer to the entire feature under discussion, and those that just
refer to sub-features.
2019-03-08 16:48:27 -08:00
Natalie Weizenbaum
7fd5bd1c7a Tweak impl status styling
* Make the font smaller to make them less prominent and help visually
  associate the callout with the list.
* Decrease the top margin to more clearly associate them with their
  preceding header.
* Lighten the callout background when in another callout to make it
  more visible.
* Animate the expand button.
2019-03-08 16:45:43 -08:00
Natalie Weizenbaum
681d63c698 Follow the style guide for implementation notes 2019-03-08 15:26:48 -08:00
Natalie Weizenbaum
488d656af3 Add a docsearch class to the has_no_sidebars layout
This ensures the Ruby Sass, Dart Sass, and Install pages get indexed.
2019-03-07 11:51:42 -08:00
Natalie Weizenbaum
93b739b04f Show SCSS syntax by default 2019-03-04 19:32:49 -08:00
Jina Anne
f6f238b3ea callout update 2019-03-04 19:11:26 -08:00
Jina Anne
902ca93412 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2019-03-04 18:36:39 -08:00
Jina Anne
e541d4a6ef impl 2019-03-04 18:36:34 -08:00
Natalie Weizenbaum
ce1dfc1585 Fix some mixed-up links 2019-03-04 18:30:15 -08:00
Jina Anne
50eef3ca48 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2019-03-04 18:29:30 -08:00
Jina Anne
ac992b3233 implementation 2019-03-04 18:29:20 -08:00
Natalie Weizenbaum
40e116a9ed Include return types in function signatures
Closes #298
2019-03-04 18:28:38 -08:00
Natalie Weizenbaum
8274243798 Fix a typo 2019-03-04 18:08:04 -08:00
Jina Anne
aa8ba21b75 fix code 2019-03-04 18:07:39 -08:00
Jina Anne
ff521bdbd0 fix code 2019-03-04 18:06:06 -08:00
Jina Anne
0408f08bd7 improve search box alignment 2019-03-04 18:03:07 -08:00
Jina Anne
2aea914aef Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2019-03-04 17:54:40 -08:00
Jina Anne
24fd1d9dd3 type tweak 2019-03-04 17:51:45 -08:00
Natalie Weizenbaum
0e8da5c350 Don't use :code for code blocks (#296)
For some reason, :code seems to add an empty line at the end of its
code block. This uses Markdown code blocks instead, although in order
to work around a RedCarpet bug it has to indent them strangely.
2019-03-04 19:46:32 -06:00
Jina Anne
1172c29570 impl-status styling 2019-03-04 17:27:20 -08:00
Jina Anne
03372dc401 style functions 2019-03-04 17:19:06 -08:00
Jina Anne
6a67728ab5 fix nav item spacing 2019-03-04 16:59:06 -08:00
Jina Anne
97042a5a28 make nav code not wrap 2019-03-04 16:55:24 -08:00
Jina Anne
096c6512f3 condense home 2019-03-04 16:50:23 -08:00
Jina Anne
94c9c002ec make call outs less… called out 2019-03-04 16:24:31 -08:00
Jina Anne
8aa45d75a3 make syntax switcher heading unique 2019-03-04 14:41:21 -08:00
Jina Anne
fcff312333 un-contain the dart sass page 2019-03-04 14:03:41 -08:00
Jina Anne
94aa8c62e0 fix ruby sass page 2019-03-04 13:57:56 -08:00
Natalie Weizenbaum
7cc3b1b375 Automatically add nice header linking behavior (#280)
* Make link headers look and work more like GitHub's

* Automatically generate links for all headers

* Flash headers when they're selected

* update readme
2019-03-04 15:16:52 -06:00