4 ms·

To add a bit of context: the React docs were previously a Jekyll site that was hosted at facebook.github.io/react/. The new site was rebuilt using Gatsby.js (a

To add a bit of context: the React docs were previously a Jekyll site that was hosted at facebook.github.io/react/. The new site was rebuilt using Gatsby.js (a React-based static site generator), uses the Glamor CSS-in-JS library for styling, and has a bunch of nice tweaks and improvements overall, like the live component editors on the front page.

hajile 9y ago
Can you change the docs section dropdown interaction? When I go to look at the docs, it's really nice to be able to see everything instead of opening each major section one at a time (especially when opening one closes all the others).
O4epegb 9y ago
I think editors was already there.
- acemarke 9y ago
  They might have had _something_ on the front page before, don't remember what exactly. I know they had CodePen examples added in the "Getting Started" and "Tutorial" sections when the docs content was rewritten last year. The use of the React-Live editor widget on the front is specifically new, I just don't remember if it replaced something similar previously.
bluetidepro 9y ago
Wow, just checked out Gatsby.js for the first time. This library is incredible. Glad you mentioned it! :)
- SkyPuncher 9y ago
  I cannot overstate how nice it is to use. I built a sign-up page for a startup with it and I had absolutely no complaints. Writing static content is basically like building a normal website with a nice templating system. Dynamic content is simply React components that I'm use to working with on complex applications. Easy to build, easy to deploy, and easy to change.
  - calcsam 9y ago
    That's great to hear!
Kiro 9y ago
Where are they using Glamor? Trying to find some code in action but can't search on mobile.
futurefriendly 9y ago
Gatsby is great but it has issues generating sites with a large number of pages. There are performance issues and generation fails if the number of pages goes above a certain threshold. I had to abandon it for a project that was generating static SEO pages, it was something on the order of 2000 pages and Gatsby couldn't handle it. Hopefully they resolve that soon!
- coldtea 9y ago
  >Hopefully they resolve that soon! Or, hopefully, they don't. SEO pages suck users time.
  - free_everybody 9y ago
    Could you fill me in? Why do SEO pages suck users time? I'm a newbie.
    - coldtea 9y ago
      SEO pages are crap meant to make a site with otherwise no interesting content (else it would have used that) rank higher on Google.
  - futurefriendly 9y ago
    I can see how you'd have that perception but the term covers a wide swath of use cases. Search engine spam is not nearly the issue it once was. Most SEO pages are created to account for two things: product marketing content cannot contain all the possible terms that people use when searching without becoming unintelligible and data served dynamically through SPAs, especially geographically localized data, is still challenging to expose to search engines even with universal apps.
- calcsam 9y ago
  Sorry to hear that! We're focusing on build performance and incremental site builds and will be releasing a major version bump by the end of the year to make the experience faster.

hajile 9y ago

Can you change the docs section dropdown interaction? When I go to look at the docs, it's really nice to be able to see everything instead of opening each major section one at a time (especially when opening one closes all the others).

O4epegb 9y ago

I think editors was already there.

acemarke 9y ago
They might have had _something_ on the front page before, don't remember what exactly. I know they had CodePen examples added in the "Getting Started" and "Tutorial" sections when the docs content was rewritten last year. The use of the React-Live editor widget on the front is specifically new, I just don't remember if it replaced something similar previously.

bluetidepro 9y ago

Wow, just checked out Gatsby.js for the first time. This library is incredible. Glad you mentioned it! :)

SkyPuncher 9y ago
I cannot overstate how nice it is to use. I built a sign-up page for a startup with it and I had absolutely no complaints. Writing static content is basically like building a normal website with a nice templating system. Dynamic content is simply React components that I'm use to working with on complex applications. Easy to build, easy to deploy, and easy to change.
- calcsam 9y ago
  That's great to hear!

Kiro 9y ago

Where are they using Glamor? Trying to find some code in action but can't search on mobile.

futurefriendly 9y ago

Gatsby is great but it has issues generating sites with a large number of pages. There are performance issues and generation fails if the number of pages goes above a certain threshold. I had to abandon it for a project that was generating static SEO pages, it was something on the order of 2000 pages and Gatsby couldn't handle it. Hopefully they resolve that soon!

coldtea 9y ago
>Hopefully they resolve that soon! Or, hopefully, they don't. SEO pages suck users time.
- free_everybody 9y ago
  Could you fill me in? Why do SEO pages suck users time? I'm a newbie.
  - coldtea 9y ago
    SEO pages are crap meant to make a site with otherwise no interesting content (else it would have used that) rank higher on Google.
- futurefriendly 9y ago
  I can see how you'd have that perception but the term covers a wide swath of use cases. Search engine spam is not nearly the issue it once was. Most SEO pages are created to account for two things: product marketing content cannot contain all the possible terms that people use when searching without becoming unintelligible and data served dynamically through SPAs, especially geographically localized data, is still challenging to expose to search engines even with universal apps.
calcsam 9y ago
Sorry to hear that! We're focusing on build performance and incremental site builds and will be releasing a major version bump by the end of the year to make the experience faster.