Update documentation for Build Sequence and Client Sequence #31206
Replies: 19 comments
-
|
@tanvibhakta Thanks for raising this issue. I agree that it'll involve a good amount of code reading to understand how things work in Gatsby. Would you be open to work on this? |
Beta Was this translation helpful? Give feedback.
-
|
This might be of help to you: Behind the Scenes |
Beta Was this translation helpful? Give feedback.
-
|
No, I don't think I will have the time to work on this. :/ |
Beta Was this translation helpful? Give feedback.
-
|
Old issues will be closed after 30 days of inactivity. This issue has been quiet for 20 days and is being marked as stale. Reply here or add the label "not stale" to keep this issue open! |
Beta Was this translation helpful? Give feedback.
-
|
Hey again! It’s been 30 days since anything happened on this issue, so our friendly neighborhood robot (that’s me!) is going to close it. Please keep in mind that I’m only a robot, so if I’ve closed this issue in error, I’m Thanks again for being part of the Gatsby community! |
Beta Was this translation helpful? Give feedback.
-
|
Hi there! In feedback on gatsbyjs.org, this page resurfaced as needing an update. Specifically:
Behind the Scenes, now called Gatsby Internals, would be a good resource in writing this doc. Gatsby Node APIs, Gatsby SSR APIs, and Gatsby Browser APIs would likely be useful docs to reference as well. I've also opened #14937 for "Life and Times of a Gatsby Build", which would include similar information as this Lifecycle APIs page: it's currently in the same "Conceptual Guide" section, but would be more high-level whereas this would be about API details. I'd argue that this Lifecycle APIs doc could move into Gatsby APIs in the sidebar to differentiate a bit. It could be a conceptual parent of the Node/SSR/Browser API pages, that instead talks about how they work together. I'm open to ideas, and this is up for someone to take on! |
Beta Was this translation helpful? Give feedback.
-
|
@alexlbr and I just got off a call discussing this. Alex will be picking this up! |
Beta Was this translation helpful? Give feedback.
-
|
@sidharthachatterjee thanks for taking the time to walk me through the code. Yes, I'll give work on this in the next days 💪 |
Beta Was this translation helpful? Give feedback.
-
|
Hey @alexlbr, how's it going on this? Anything we can help with? |
Beta Was this translation helpful? Give feedback.
-
|
@marcysutton I spoke with @sidharthachatterjee last week to schedule some pair programming cause I needed some help. Sid is on holiday so we scheduled it for next week. I didn't think it was relevant so I didn't update it here. Sorry about that, and thanks checking if I need help :) |
Beta Was this translation helpful? Give feedback.
-
|
@alexlbr That was a fantastic chat! Thank you so much for setting this up and taking the time to work on this, Alex. @marcysutton We've discussed Bootstrap and Build Sequence so far which Alex is going to be writing up and will set up another call for the Client Sequence once these are in! (Will link to the recording of our call from today once it is ready) |
Beta Was this translation helpful? Give feedback.
-
|
Topic: Alex Lobera: 30 Minute Meeting Meeting Recording: |
Beta Was this translation helpful? Give feedback.
-
|
@marcysutton as discussed with @sidharthachatterjee: |
Beta Was this translation helpful? Give feedback.
-
|
@sidharthachatterjee I followed these instructions for the pull request https://www.gatsbyjs.org/contributing/setting-up-your-local-dev-environment/#gatsby-repo-install-instructions but CircleCI gave this error "Out of them, 1 sites were not a Gatsby site". Did I do something wrong? How can I help to fix it? |
Beta Was this translation helpful? Give feedback.
-
|
@alexlbr how's it going with this issue? Are you still working on a PR? You can typically ignore most of the CI checks when working on a docs PR (aside from linting). |
Beta Was this translation helpful? Give feedback.
-
|
Hi @marcysutton, I was waiting for the first part to be merged to continue with the rest. I plan to work on the build sequence next week. |
Beta Was this translation helpful? Give feedback.
-
|
Hey @alexlbr, looks like that PR was merged so you should be good to go now! Do you need anything from us to get started? |
Beta Was this translation helpful? Give feedback.
-
|
Hey @alexlbr, checking up on this issue–are you still able to work on this, or should we open it back up for someone else to take on? |
Beta Was this translation helpful? Give feedback.
-
|
@marcysutton sorry for being slow finishing this. I would like to work on it. Unfortunately, I won't be able to allocate any time in the next 2 or 3 weeks. If this issue is very urgent then go ahead and open it back, otherwise thanks for your patience :) |
Beta Was this translation helpful? Give feedback.
-
The documentation on this page https://www.gatsbyjs.org/docs/gatsby-lifecycle-apis/#build-sequence
detailing how the build-sequence and client-sequence works is missing (and I don't see an open issue for this available already.)
I think this might take some reading of the code, to understand how the things work before writing them in a simplified manner? Not sure if there are already other resources available that we can then integrate into this.
Beta Was this translation helpful? Give feedback.
All reactions