Skip to content

Commit ee70f9d

Browse files
Thomas Wangsidharthachatterjee
authored andcommitted
[docs] improving Themes completeness (#18602)
1 parent 630e3d3 commit ee70f9d

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

docs/docs/themes/what-are-gatsby-themes.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,28 @@ Themes solve the problems that traditional starters experience:
2727

2828
> A Gatsby theme is effectively a composable Gatsby config. They provide a higher-level approach to working with Gatsby that abstracts away the complex or repetitive parts into a reusable package.
2929
30+
## When should I use or build a theme?
31+
32+
**Consider using a theme if:**
33+
34+
- You already have an existing Gatsby site and can't start from a starter
35+
- You want to be able to update to the latest version of a feature on your site
36+
- You want multiple features on your site, but there is no starter with all the features -- you can use multiple themes, composed in one Gatsby site
37+
38+
**Consider building a theme if:**
39+
40+
- You plan on re-using similar functionality across multiple Gatsby sites
41+
- You would like to share new Gatsby functionality to the community
42+
3043
## What's next?
3144

3245
- [Using a Gatsby Theme](/docs/themes/using-a-gatsby-theme)
3346
- [Using Multiple Gatsby Themes](/docs/themes/using-multiple-gatsby-themes)
47+
- [Shadowing](/docs/themes/shadowing/)
3448
- [Building Themes](/docs/themes/building-themes)
49+
- [Converting a Starter](/docs/themes/converting-a-starter/)
50+
- [Theme Composition](/docs/themes/theme-composition/)
51+
- [Conventions](/docs/themes/conventions/)
3552

3653
## Related blog posts
3754

0 commit comments

Comments
 (0)