ReCoded-Org / curriculum-backend-readings

Content monorepo for all the readings of the backend bootcamp curriculum developed by Re:Coded.
23 stars 4 forks source link

Module 1 feedback #23

Open louisrli opened 2 years ago

louisrli commented 2 years ago

1 Introduction to Backend

Looks fine to me.

1.1 Beginners guide to Node.js and NPM

1.2

2 HTTP and REST

2.1 Diving into REST APIs

I feel that the breakdown of requests and responses might actually be too detailed. The harm in this is that students might think they need to know all these details about requests and responses, which you don't -- in practice you just need to understand that a request/response has a bunch of key-value pairs in different places, and then it has a body (basically I'd base this off APIs like Express etc that let you access parts of the request).

All the stuff about encodings and stuff seems quite extraneous to me; I'd consider slimming down this section and moving a lot to "additional reading." IMO introductory texts should not aim to be a comprehensive reference.

For example, I've never heard of things like absolute form, authority form, etc, and as far as I know we are almost never, ever dealing with raw request/response in practice.

2.2 Testing APIs with Postman

Looks fine

3 Introduction to Express.js

3.1 Meme website

3.2 Meme API

4 API Best Practices

4.1 Server-side validation

4.2 Validation practice

5 API Documentation

It's good

5.1 API practice

It's good

Overall module looks pretty good.

louisrli commented 2 years ago

sorry submitted it a bit early since I didn't trust the auto-save functionality -- should be completed now