Commit Graph

73 Commits

Author SHA1 Message Date
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
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
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
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
78429ae1b4
Add permalink icons to function API docs (#309)
Closes #308
2019-03-18 17:49:03 -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
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
Jina Anne
f6f238b3ea callout update 2019-03-04 19:11:26 -08:00
Jina Anne
e541d4a6ef impl 2019-03-04 18:36:34 -08:00
Jina Anne
ac992b3233 implementation 2019-03-04 18:29:20 -08:00
Jina Anne
0408f08bd7 improve search box alignment 2019-03-04 18:03:07 -08:00
Jina Anne
24fd1d9dd3 type tweak 2019-03-04 17:51:45 -08: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
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
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
Jina Anne
7ee1b68df5 link header 2018-12-28 18:03:50 -08:00
Jina Anne
4785328dff hover link 2018-12-28 18:01:32 -08:00
Jina Anne
c21200ba14 header linking 2018-12-28 17:59:53 -08:00
Jina Anne
fb5eb4f52c Clean up style guide 2018-12-28 17:26:36 -08:00
Jina Anne
9a4d66643e add list documentation 2018-12-28 17:03:29 -08:00
Jina Anne
c0478b1f89 remove broken sticky plugin 2018-12-28 16:50:04 -08:00
Jina Anne
6db6cad349 nav progress 2018-12-28 16:42:05 -08:00
Jina Anne
698ff52e1d remove nav border 2018-12-28 16:32:00 -08:00
Jina Anne
c7f02d1a44 more visible links 2018-12-28 16:13:58 -08:00
Natalie Weizenbaum
25a40e45f9 Pad the syntax switcher with newlines rather than CSS padding (#266)
* Pad the syntax switcher with newlines rather than CSS padding

* Style nit
2018-12-28 14:57:14 -08:00
Jina Anne
936bc03a6c fix syntax errors 2018-12-28 14:55:48 -08:00
Jina Anne
8b2d48f774 merge in master 2018-12-27 19:47:31 -08:00
Jina Anne
69272daa3b
fix arrow icon with unicode character (#235)
* fix arrow icon with unicode character

* use bigger, bolder arrow
2018-12-27 17:33:42 -08:00
Jina Anne
67020d2037 merge conflicts 2018-12-27 16:50:00 -08:00
Jina Anne
92d9baf850 fix nav 2018-12-27 16:43:43 -08:00
Jina Anne
66f3526bd5 major clean up 2018-12-27 16:31:28 -08:00
Natalie Weizenbaum
378efd127c Embed the railroad diagram as an object
Including it inline caused some conflicts with the markdown parser.
2018-11-29 17:23:23 -08:00
Jina Anne
6620433c50 redo holy grail layout 2018-10-26 23:37:10 -07:00
Jina Anne
c81d53b5ec refactor breapoints 2018-10-26 23:06:47 -07:00
Jina Anne
7b26d6b684 clean up functions update intended code style in style guide 2018-10-26 21:35:30 -07:00
Jina Anne
3f1c2d338d lots of clean up 2018-10-23 15:06:39 -07:00
Natalie Weizenbaum
6030761158 Add a helper for writing inline multi-syntax examples (#226)
* Add a helper for writing inline multi-syntax examples

This will be useful for #205.

* Add the ability to add CSS output to the syntax switcher

* Automatically generate CSS for the syntax switcher by default

* Fix most lints

* Fix a specificity bug

* Show SCSS syntax by default

* Fix a couple more lints

* Make the example helper template-engine-agnostic

* Support a "syntax switcher" with a single syntax

This will make it possible to do nice-looking single-syntax code
examples in the reference.

* Remove trailing whitespace
2018-10-22 12:00:45 -07:00