Groking redwood

100% agree.

I recently set up my first Gatsby site, and doing so I went through their tutorial. It’s very thorough, even going so far as helping you install node, git, going through code editors, etc. But even they thought it would be too much to explain/teach GraphQL, so they link out to an external tutorial about that

NOTE: Gatsby’s data layer is powered by GraphQL. For an in-depth tutorial on GraphQL, we recommend How to GraphQL.

https://www.gatsbyjs.org/tutorial/part-four/

Yes you can. I did :slight_smile:

Yes, a lot of Googling requried…

I love this part of the tutorial, I referenced back to it several times. Very good :+1:
And yes, it does reference both Apollo and Prisma, but even so I first didn’t understand what was used for what. I think a visual diagram would have been helpful to me.

Yes! This would have been perfect. And I agree about the labels, that’s what I’m afraid would happen too.

I think links at the start of the tutorial, and at the end of the tutorial would both be helpful

Before tutorial:
“Make sure you’re familiar with these things before starting”

  • link 1
  • link 2

and

After tutorial:
“Read this if you want to know even more and dig deeper”

  • link 1
  • link 2

I just found their SpaceX tutorial earlier today and have started working though it. It does look very good so far!

I think Redwood is in a bit of a unique situation in that it does so much! So naturally there are a lot of things to explain. We can’t possibly include full tutorials for React, Apollo, Prisma, Netlify Functions, TailwindCSS (or whatever styling thing to use) etc.

2 Likes

Just to be super clear, this kind of diagram is what I think would have helped me

As you can probably tell from my Paint skillz I’m not your guy to actually make said diagram… :laughing:

5 Likes

@Tobbe This is a really great blog post that helped me grok GraphQL and caching according to Apollo.

1 Like

Just finished going through the Apollo tutorial. It started off great, but deteriorated a bit towards the end. Still super helpful for my understanding of gql/apollo though :+1:

Made me want to write my own version of that tutorial, but targeting Redwood :smiley: Too bad I have a job to do as well that’s taking all my time :stuck_out_tongue:

1 Like

Not sure I’d be hitting any relevant part of the mark here but…
I’m pretty new to all of it and Typescript was a ah-ha! moment to me, most specifically on the api side.
The one thing that really, really tied a lot together was seeing this part of the doc:

I could finally use the generated types of my schema directly in my code, which makes navigation through it a lot easier and helps seeing how things work between the schema, the sdls and the services. I feel mostly in charge of my wild api thanks to it x), but I admit, it’s a lot to take on.

2 Likes

Ok, this is all really good discussion and speaks to what I think is a priority theme emerging from new Redwood developers --> Something akin to:

“…you talk about the Redwood API, but where does Redwood end and Prisma, or Postgres, or Apollo GraphQL, or Lambda Functions, or Services, or … begin?”

For individuals new to Redwood (i.e. most all of us :wink:) it’s no trivial task just to round up which documentation goes with which components.

Potential Next Step: Virtual Meetup

I’m blocking off Thursday, July 9th from 10:30-12:00pm Pacific to figure out how to use https://hopin.to/ (expo/booth feature) to host an informal community conversation about these topics. The topic will be the Redwood API. The goal will be two-fold:

  1. identify common API questions and pain points for developers “getting started” with Redwood
  2. through informal walkthroughs and brief, lightweight presentations, identify which explanations and resources are most helpful

We can use this discussion (and others) to source some topics for a fluid agenda. And anyone who’d like some time to present or ask questions could be scheduled as well. But overall, the Hopin service will allow people to drop in and out of the main conversation while everyone can watch and participate by chat.

  • Count me in (that date/time works)
  • Count me in (but different date/time)
  • Interesting but not of value to me specifically
  • Meh, I don’t see the value/need

0 voters

10:30 am PST is 5:30 pm GMT/UTC and 19:30 CET
Hope I got that right, timezones are a pain :clock1030:

1 Like

@Tobbe Prisma’s Data Guide is available as of today:

@dom @Tobbe @Terris @tctrautman

Ok, we’re one for a Meetup/Discussion tomorrow! We’re going to give this a go over the course of an hour with a small group. (The date/time displayed below should be localized to you.)

2020-07-09T17:30:00Z2020-07-09T18:30:00Z

After Dom and I tested out the software, we’re going to borrow from Prisma and flag this as --experimental. There are definitely some UX issues to work out if we’re attempting to run this through the Hopin event software.

And, to be clear, even though this is a trial run your participation is needed and valuable :100:!!

Here’s the plan:

  • we’re limiting this to 5 people. Each of you has first dibs on a “ticket” to join. If you are still available, DM me for a link to get access.
    • Anyone who’s interested is welcome to DM me. I’ll sort invites based on “first come” basis.
  • Step 1: we need to understand your experience joining the discussion using Hopin. So I won’t give specific instructions. BUT we’ll be on Discord for a backchannel to help each other out in case of problems.
  • Step 2: once we’re all in the virtual Meetup, we’ll debrief the experience and try out some functionality (chat, drop-in to live video, screen share, etc.)
  • Step 3: we’ll dive into some topics about Redwood API and current state of the union. Together, we’ll put together a plan for a larger, public group Meetup we’ll schedule for later next week.

Make sense and sound like a plan?

Hope to see you tomorrow. :crossed_fingers:

3 Likes

@thedavid I’m looking forward to this! FYI I just tried sending you a DM to get the link and received an error saying that you weren’t receiving messages right now. I think there might be some Discourse settings that need tweaking.

Ah, sorry about that! Sending you the link now by DM. Excited you’re able to join.

1 Like

Would love a quick recap of the meetup if anything interesting was said :slight_smile: Super sad I couldn’t make it today :frowning:

Partly testing the system and then making some plans for a full go next week. I’ll post some potential topics for discussion.

More to come!

2 Likes

All right, Meetup event registration for this Friday is live!

https://community.redwoodjs.com/t/our-first-public-virtual-meetup-is-this-friday-join-us/910/2

3 Likes

@Terris @tctrautman

Wanted to see if either of you were interested in kicking off specific topics or questions during tomorrow’s public Meetup? The idea would be to share (over the course of several minutes) some questions you have related to the Redwood API or an “ah-ha!” momentum you had. You don’t need to be an expert. But, rather, kick start a discussion about a topic.

No pressure, but let me know if you’re interested and I’ll put you on my list.

Lastly, tomorrow’s going to be a bit of an experiment. So no promises on my end about how things are going to go. We’ll have fun regardless :wink:

I think I can come up with a few questions :wink:

1 Like

Perfect! We’ll see how it goes. No need to prepare anything other than a question or two. If we seem to be at a lull and need to kick start conversation, I might use that as an opportunity to have you initiate a conversation (with my help). Sound like a plan?

@thedavid I also have a question that might be a good topic for group discussion for if conversation slows down.

Also, I’m not sure this fits in the “ah-ha!” moments bucket… and I’m sure this is incomplete or perhaps even misleading in some places, but I put this together after our conversation last week with the thought that it might be helpful for new folks coming into the community who aren’t familiar with the boundaries between the tools and Redwood concepts:

8 Likes

This is great! Sorry I didn’t see it until just now. Could you create a new forum topic, e.g. “Mapping Redwood API Concepts to Tools” and post this!?!

Thanks again.

@thedavid thanks and good call! Posted here: Mapping Redwood concepts to tools

1 Like