Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add info on plugins, themes, and starters #20025

Merged
merged 6 commits into from
Dec 13, 2019

Conversation

marcysutton
Copy link
Contributor

Description

I hear often that people still don't understand the differences between plugins, themes, and starters, so I created this PR. It adds a few explanations in the docs as well as a new Conceptual Guide.

Related Issues

Related to https://github.com/gatsbyjs/gatsby/projects/10#card-30093971

A good follow-up task would be to add a decision tree or flow chart to help people decide which type of code organization to use.

@marcysutton marcysutton requested review from a team as code owners December 9, 2019 23:56
@marcysutton marcysutton added the type: documentation An issue or pull request for improving or updating Gatsby's documentation label Dec 9, 2019
Copy link
Contributor

@laurieontech laurieontech left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is awesome and incredible helpful!

I do struggle a bit with how we convey that themes are plugins and also talk about their differences. I made a couple of suggestions below but open to other ideas.

Co-Authored-By: LB <barth.laurie@gmail.com>
@marcysutton
Copy link
Contributor Author

Thanks @laurieontech! I think there's still more detail we could add, but it could be done as part of the plugins/themes workflow. I've added your suggestions in the meantime, so hopefully we can keep this one moving along!

@laurieontech
Copy link
Contributor

Looks awesome! Excited to get this in.

@laurieontech laurieontech merged commit a7ccb72 into master Dec 13, 2019
@delete-merged-branch delete-merged-branch bot deleted the docs-themes-plugins-starters branch December 13, 2019 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: documentation An issue or pull request for improving or updating Gatsby's documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants