-
Notifications
You must be signed in to change notification settings - Fork 10.3k
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: new source plugin tutorial #23363
Conversation
… and subscriptions
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Wanted to read through the whole thing but dang, this is long. Well done! So just a couple of comments for the first parts - if you specifically target those later in the text feel free to ignore :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What a lift Kyle! Great work. Left some recommendations.
My general opinion is that this is such a big improvement we should get it in soon and deal with any small tweaks down the road. That being said, I'd like to take a detailed look at the headings to make sure people can jump to sections if they want examples given the length of the tutorial. Would also be good to triple check we're not mixing any other pixabay references.
Co-Authored-By: Kyle Gill <kylerobertgill@gmail.com>
Co-Authored-By: LB <laurie@gatsbyjs.com> Co-Authored-By: Lennart <lekoarts@gmail.com>
Co-Authored-By: LB <laurie@gatsbyjs.com>
Co-Authored-By: LB <laurie@gatsbyjs.com>
…sby into docs/source-plugin-tutorial
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As always, this was both thorough and wonderful. I have a few non-punctuation comments but it's very nearly good to go. Thanks for all your time and work on this, Kyle!
Co-authored-by: Aisha Blake <aisha@gatsbyjs.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is looking great! Thanks for picking up those changes and for doing all this work in the first place, Kyle!
PS: i deleted my comments and will open a new issue when i completed the tutorial myself |
Description
This is the final step of the long worked on plugin authoring workflow.
This (rather big) tutorial was an effort to improve the materials supporting more advanced use cases for plugins. It's an extension of the new source plugin guide that uses a more sophisticated example for reference. That example is rebuilt in the tutorial to teach:
Retiring the Pixabay tutorial:
The Pixabay tutorial provides some good context, but doesn't explain some of those key features. I propose removing it in favor of this new tutorial, many of the sections were taken from the old guide and modified. I think this new tutorial will cover more commonly implemented features and set users up for integration with Gatsby Cloud (which was one of its goals).
View partial screenshot
Related Issues
Fixes #16095