Join GitHub today
Migrate reference docs #205
The Sass reference has never been the most user-friendly documentation, and as Ruby Sass moves towards end-of-life it'll be more important not to pull the primary source of language documentation from its repository and infrastructure. I think the best thing to do would be to make the reference documentation a native part of the site, and take that opportunity to rethink how it's presented. This includes function documentation, which is currently even more tightly coupled to Ruby.
@sass/core @sass/sass-site I'm happy to take on the work of and updating the prose, but I could use some help figuring out the best way to present it. I'm thinking roughly taking each sub-section of the existing reference and making it a separate page, with some sort of table of contents making it easier to navigate. Python's language documentation is good prior art here, but I'd very much appreciate suggestions from folks who regularly consume this sort of documentation.
I'll also need some design assistance getting the reference layout looking nice and consistent with the rest of the site.
We should also be careful to ensure that widely-used existing URLs continue to work. In particular:
referenced this issue
Mar 26, 2018
This was referenced
Apr 5, 2018
@jina I think there's enough material now on the
I leave the details and the final decision-making in your capable hands, though!