[docs][recipes] rearrange and add new recipes on Pages and Layouts #15620
Conversation
docs/docs/recipes.md
Outdated
| } | ||
| } | ||
| } | ||
| `).then(result => { |
There was a problem hiding this comment.
Splitting hairs: the next example uses async/await, not sure one is preferred over the other or if that consistency really matters too much though.
There was a problem hiding this comment.
Great point! We should update it. I forget where that example came from exactly, but I think it's in the docs somewhere.
There was a problem hiding this comment.
Pushed an update!
| pathPrefix: `/yourpathprefix`, | ||
| } | ||
| ``` | ||
| Starters are boilerplate Gatsby sites maintained officially, or by the community. |
There was a problem hiding this comment.
One more thing -- for some reason this is under ## Creating layouts and it should be under ## Working with starters (right below).
Not sure if there was other content you wanted to add for ## Creating layouts?
There was a problem hiding this comment.
Thanks! That's a good place to start for themes - ultimately we'll want it to follow the new format though: https://www.gatsbyjs.org/contributing/docs-templates/#recipes
There was a problem hiding this comment.
This is challenging. Should it be split into "Using a theme" and "Building a theme"?
There was a problem hiding this comment.
merging as-is, will address later.
amberleyromo
added
the
bot: merge on green
Description
I added the new recipes for Pages and Layouts to get this docs train moving! This PR also includes some of the restructuring I proposed in previous issues (and in the recipe spreadsheet).
New recipes in this PR:
createPage(bonus recipe!)I also added a numbering system (1.1, 1.2, 2.1, etc.) since these are longer than I'd hoped to still be actionable on-page - that's a goal of these content pieces. I think the Table of Contents in #15251 will help a lot, too, and we could potentially add an expand/collapse component in the future to make the page easier to digest and scan.
Related Issues