Gatsby: [docs][guides] add details about user stylesheets with Styled Components

Created on 29 Jun 2019  路  5Comments  路  Source: gatsbyjs/gatsby

Summary

In feedback from gatsbyjs.org, the Styled Components styling doc could use a little more information around user stylesheets. Specifically:

in the last part where would a user write their CSS for the line "A site user could then write their own CSS styles matching HTML elements with a class name of .container, and it wouldn鈥檛 be affected if the CSS-in-JS output changed."

It could be that the term "user" is what's confusing here, since this section is referring to end-users creating their own stylesheets for accessibility and other purposes. I have three recommendations:

  • Refer to users in this scenario as "end-users" to differentiate from "Gatsby users" (developers)
  • Include a short CSS snippet that references the .container class, and give it a file title like css:title=user-stylesheet.css.
  • Add a link to more information on writing and including user stylesheets. Here's a recent-ish-looking post we could link to by Chris Coyier: https://mediatemple.net/blog/tips/bend-websites-css-will-stylish-stylebot/
help wanted feedback documentation

All 5 comments

Hi Marcy, I'd like to take this one if it's not taken

Absolutely @luizcieslak, we'd love to have your contributions! Let me know if you have any questions.

Hiya!

This issue has gone quiet. Spooky quiet. 馃懟

We get a lot of issues, so we currently close issues after 30 days of inactivity. It鈥檚 been at least 20 days since the last update here.

If we missed this issue or if you want to keep it open, please reply here. You can also add the label "not stale" to keep this issue open!

As a friendly reminder: the best way to see this issue, or any other, fixed is to open a Pull Request. Check out gatsby.dev/contributefor more information about opening PRs, triaging issues, and contributing!

Thanks for being a part of the Gatsby community! 馃挭馃挏

@marcysutton Up for claims ?

@kushthedude yes, go for it!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

theduke picture theduke  路  3Comments

ferMartz picture ferMartz  路  3Comments

mikestopcontinues picture mikestopcontinues  路  3Comments

benstr picture benstr  路  3Comments

dustinhorton picture dustinhorton  路  3Comments