Getting started guide needs example prompts

[allanday]

The getting started guide needs 3 example questions and 1 example follow-up question:

https://github.com/Granite-Code/docs.granitecode.github.io/blob/main/docs/getting-started.md?plain=1#L22

Ideally each example would demostrate a different category of question, and those categories should be widely relevant.

@owtaylor

[owtaylor]

1. What is an asynchronous iterator in Javascript?
2. In react, I want to get information from the server when the component is created. How do I do that?
3. When working with react, how do I see if my component is being rendered too much?

Followup:
4. OK, using React devtools, I see that a big list is getting rerendered when I type into the text box next to it. How do I fix that?

(I don't love the followup because that would be better asked with code rather than abtractly. Could follow up to to 2.

Why does your example pass [] as the last argument to useEffect()?

but that doesn't read well. Plus it assumes the reader actually has some knowledge of react.)

@panyamkeerthana @fbricon - does one of you want to take a stab at:

3. TODO: best practices question. I am writing X. How do I make sure that it is performant?

Once you have asked a question, you can ask follow-up questions about the model's response. For example, TODO.

[panyamkeerthana]

'Now that the I know how to fetch the data for when a component first shows up, how do I show a loading spinner to the user while waiting for the response?'

'How can I handle loading and error states while fetching this data in react?'

'How do I prevent unnecessary server requests when data doesn't change?'

(would any of these work? @owtaylor )

[allanday]

It would be good if we could have examples that cover different types of use cases and technologies, in order to increase their potential relevance. It would be good if it wasn't just JS/React.

The previous Python example from Owen was quite good: "Create a Python script to take a CSV file with lines like ",,<test_score>" and output a table of average test score by grade"

The main issue I have with it is that the reason for the format of the CSV file isn't immediately obvious. Also "a table" is a bit vague - what type of table?

[panyamkeerthana]

1. What is an index in SQL, and why is it important?
2. I have a CSV file where each line has "student_id, subject, test_score" How do I write a Python script to output a table of average test score by subject?
3. In React, I want to get information from the server when the component is created. How do I do that?

Followup:
How can I handle loading and error states while fetching this data?

[allanday]

Those latest suggestions sound great to me. Do you want to make those changes, @panyamkeerthana , or should I?

[panyamkeerthana]

I could make the changes! :)